contents(コンテンツ③：コンテンツメタデータの取得・変更) – millvi

contents（共通要素）はこちらを参照してください。

POST : /contents/modify_contents_info（コンテンツの情報を変更）
GET : /contents/get_video_details（動画・音声の詳細情報を取得）
POST : /contents/modify_video_info（動画・音声の情報を変更）
GET : /contents/get_image_details（画像の詳細情報を取得）
POST : /contents/modify_image_info（画像の情報を変更）
GET : /contents/get_video_thumbnails（動画・音声に登録されているサムネイル一覧を取得）
POST : /contents/set_video_thumbnail（動画・音声のサムネイルを選択）
GET : /contents/download_original（元動画・元音声・画像・PDFをダウンロードする）
GET : /contents/get_pdf_details（PDFの詳細情報を取得）
POST : /contents/modify_pdf_info（PDF情報を編集）
POST : /contents/replace_contents（動画・音声・画像・PDFを差し替える）
GET : /contents/get_preview_url（PDF、画像プレビュー用コンテンツURLを取得）
POST : /contents/delete_thumbnail（動画・音声のサムネイルを削除）
GET : /contents/get_video_keitai_details（動画・音声のケータイ詳細情報を取得）
POST : /contents/modify_video_keitai_info（動画・音声のケータイ情報を変更）
POST : /contents/modify_video_keitai_encoding（ケータイ動画・音声を再変換）
POST : /contents/delete_video_keitai（ケータイ動画・音声を削除）
GET : /contents/get_video_youtube_details（動画・音声のYouTube詳細情報を取得）
POST : /contents/modify_video_youtube_info（動画・音声のYouTube情報を変更）
POST : /contents/delete_video_youtube（YouTube動画・音声を削除）
GET : /contents/get_video_common_details（動画・音声のcommon詳細情報を取得）

`POST` : `/contents/modify_contents_info`

概要

コンテンツの情報を変更。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
name (required)	コンテンツ名 (name、description、metatagいずれかは必須)
description (required)	説明文 (name、description、metatagいずれかは必須)
metatag (required)	タグの設定 (name、description、metatagいずれかは必須)
visible	公開設定・`0` : 非公開・`1` : 公開・`DATE,DATE` : 期間公開

ステータス

有効

`GET` : `/contents/get_video_details`

概要

動画・音声の詳細情報を取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
video	動画・音声情報
name	コンテンツ名
id_contents	コンテンツID
description	説明文
metatag	メタタグ
visible	公開設定・`0` : 非公開・`1` : 公開・`DATE,DATE` : 期間公開
create_date	投稿日時 `YYYY-MM-DD HH:II:SS`
duration	コンテンツの秒数
original_filename	元動画・元音声のファイル名
original_format	元動画・元音声のフォーマット
original_filesize	元動画・元音声のファイルサイズ(byte)
original_width	元動画の幅
original_height	元動画の高さ
original_exif	元動画・元音声のexif情報（JSON形式）出力される値はこちらのリンク(元動画・元音声・元画像のexif情報)をご参照ください。 ※元ファイルに存在する場合のみ出力されます。元ファイルに出力可能な値が一つも存在しない場合は空文字が出力されますのでご注意ください。
process_status	コンテンツ登録ステータス・`done` : オリジナル情報を取得可能・`idle`,`processing` : オリジナル情報を取得不可能
id_video_thumbnail	サムネイルID
meta_url	関連画像に付属するURL
update_date	更新日※未使用
gid	コンテンツユニークID
usermeta	USERMETA ※未指定時は空文字
id_recipe	エンコード設定のID settings/list_recipeもしくは管理画面「トランスコード設定」の一覧よりご確認ください。
subtype	コンテンツの種類・`video` : 動画・`audio` : 音声・`pdf` : PDF ・`image` : 画像・`folder` : フォルダ
opt_related_image	関連画像のコンテンツID 関連画像がある場合コンテンツIDを返す

ステータス

有効

`POST` : `/contents/modify_video_info`

概要

動画・音声の情報を編集。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
name (required)	コンテンツ名 (name、description、metatag、meta_url、usermeta、opt_related_imageいずれかは必要)
description (required)	説明文 (name、description、metatag、meta_url、usermeta、opt_related_imageいずれかは必要)
metatag (required)	タグの設定 (name、description、metatag、meta_url、usermeta、opt_related_imageいずれかは必要)
meta_url (required)	関連画像に付属するURL (name、description、metatag、meta_url、usermeta、opt_related_imageいずれかは必要)
usermeta (required)	USERMET (name、description、metatag、meta_url、usermeta、opt_related_imageいずれかは必要)
opt_related_image (required)	関連画像 (name、description、metatag、meta_url、usermeta、opt_related_imageいずれかは必要)
visible	公開設定・`0` : 非公開・`1` : 公開・`DATE,DATE` : 期間公開
update_date	更新日(省略可)※未使用

ステータス

有効

`GET` : `/contents/get_image_details`

概要

画像の詳細情報を取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
image	画像情報
name	コンテンツ名
description	説明文
metatag	メタタグ
visible	公開設定・`0` : 非公開・`1` : 公開・`DATE,DATE` : 期間公開
url	画像URL
meta_url	関連画像に付属するURL
create_date	投稿日時 `YYYY-MM-DD HH:II:SS`
original_filename	元画像のファイル名
original_format	元画像のフォーマット
original_filesize	元画像のファイルサイズ(byte)
original_width	元画像の幅
original_height	元画像の高さ
original_exif	元動画・元音声のexif情報（JSON形式）出力される値はこちらのリンク(元動画・元音声・元画像のexif情報)をご参照ください。 ※元ファイルに存在する場合のみ出力されます。元ファイルに出力可能な値が一つも存在しない場合は空文字が出力されますのでご注意ください。
process_status	コンテンツ登録ステータス・`done` : オリジナル情報を取得可能・`idle`,`processing` : オリジナル情報を取得不可能
gid	コンテンツユニークID
usermeta	USERMETA ※未指定時は空文字

ステータス

有効

`POST` : `/contents/modify_image_info`

概要

画像の情報を変更。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
name (required)	コンテンツ名 (name、description、metatag、meta_urlいずれかは必要)
description (required)	説明文 (name、description、metatag、meta_urlいずれかは必要)
metatag (required)	タグの設定 (name、description、metatag、meta_urlいずれかは必要)
meta_url (required)	関連画像に付属するURL (name、description、metatag、meta_urlいずれかは必要)
visible	公開設定・`0` : 非公開・`1` : 公開・`DATE,DATE` : 期間公開

ステータス

有効

`GET` : `/contents/get_video_thumbnails`

概要

動画・音声に登録されているサムネイル一覧を取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
thumbnail	サムネイル(※リスト)
id_video_thumbnail	サムネイルID
url	サムネイルURL
selected	選択されているサムネイル・`0` : 無効・`1` : 有効

ステータス

有効

`POST` : `/contents/set_video_thumbnail`

概要

動画・音声のサムネイルを選択。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
id_video_thumbnail (required)	サムネイルID
autocommit	自動公開処理・`0` : 無効・`1` : 有効

ステータス

有効

`GET` : `/contents/download_original`

概要

元動画・元音声・画像・PDFをダウンロードする。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID

出力

レスポンス内容

ヘッダー

名前(要素名)	値(要素の内容)
Content-Disposition	filename="ファイル名"

ボディ

名前(要素名)	値(要素の内容)
元動画・元音声・画像・PDFのデータ

備考

ただし、一般ユーザー向けのアプリ／システムには利用しないでください。
1グループで同時に3本までのダウンロード制限を設けております。 (2019/02/04時点)

ステータス

有効

`GET` : `/contents/get_pdf_details`

概要

PDFの詳細情報を取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
pdf	PDF情報
name	コンテンツ名
description	説明文
metatag	メタタグ
visible	公開設定・`0` : 非公開・`1` : 公開・`DATE,DATE` : 期間公開
create_date	投稿日時 `YYYY-MM-DD HH:II:SS`
original_filename	元PDFのファイル名
original_format	元PDFのフォーマット
original_filesize	元PDFのファイルサイズ(byte)
process_status	コンテンツ登録ステータス・`done` : オリジナル情報を取得可能・`idle`,`processing` : オリジナル情報を取得不可能
update_date	更新日(省略可)※未使用
gid	コンテンツユニークID
usermeta	USERMETA ※未指定時は空文字
domaincontrol	ドメイン制御
urls	PDF画像URL一覧カンマ区切り文字列
totalpage	ページ数

ステータス

有効

`POST` : `/contents/modify_pdf_info`

概要

PDF情報を編集。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
name (required)	コンテンツ名 (name、description、metatag、usermeta、domaincontrolいずれかは必要)
description (required)	説明文 (name、description、metatag、usermeta、domaincontrolいずれかは必要)
metatag (required)	タグの設定 (name、description、metatag、usermeta、domaincontrolいずれかは必要)
usermeta (required)	USERMETA ※未指定時は空文字 (name、description、metatag、usermeta、domaincontrolいずれかは必要)
domaincontrol (required)	ドメイン制御 (name、description、metatag、usermeta、domaincontrolいずれかは必要)
visible	公開設定・`0` : 非公開・`1` : 公開・`DATE,DATE` : 期間公開
update_date	更新日(省略可)※未使用

ステータス

有効

`POST` : `/contents/replace_contents`

概要

動画・音声・画像・PDFを差し替える。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
filekey (required)	ファイルキー
pc_nt (非推奨)	1を指定した場合、PC向け配信用動画として元動画をそのまま利用します(元動画がmp4/flv/f4vファイルのときのみ) ※ ただしflv,f4vはhtml5プレイヤーに対応しておりません。 ※【注意】エンコードがされていない動画に関しましてはサポートしかねます
sp_nt (非推奨)	1を指定した場合、SP向け配信用動画として元動画をそのまま利用します(元動画がmp4ファイルのときのみ) ※【注意】エンコードがされていない動画に関しましてはサポートしかねます
autocommit	自動公開処理・`0` : 無効・`1` : 有効

ステータス

有効

`GET` : `/contents/get_preview_url`

概要

PDF、画像プレビュー用コンテンツURLを取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
duration	動画・音声コンテンツの秒数 ※`type=video`,`type=audio`の時のみ
url	プレビュー用のコンテンツのURL ※`type=image`,`type=pdf`の時のみ
urls	プレビュー用のPDF画像URL一覧カンマ区切り文字列 ※`type=PDF`のときのみ

ステータス

有効

`POST` : `/contents/delete_thumbnail`

概要

動画・音声のサムネイルを削除。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
id_video_thumbnail (required)	サムネイルID

説明

サムネイルが0になるようなリクエストの場合はエラー。

ステータス

有効

`GET` : `/contents/get_video_keitai_details`

概要

動画・音声のケータイ詳細情報を取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
count	ケータイ動画の視聴回数制限 countが指定された場合、出力のurlがワンタイムURLを発行するためのURLになります。ワンタイムURLは指定された回数だけコンテンツの閲覧が可能になります。 ※1 以上 999 以下の時ワンタイム化されます。未指定、0以下は回数制限されません。 ※フィーチャーフォンワンタイムURLを契約済みのお客様のみ利用可能です。

出力

レスポンス内容

名前(要素名)	値(要素の内容)
video_keitai	動画・音声ケータイ要素
process_status	コンテンツ登録ステータス・`done` : オリジナル情報を取得可能・`idle`,`processing` : オリジナル情報を取得不可能
keitaimeta_name	名前
keitaimeta_descriotion	説明文
keitaimeta_author	作成者
keitaimeta_copyright	コピーライト
encoding_quality	品質(ケータイ)
url	URL countが指定された場合、ワンタイムURLが発行されます
gid	コンテンツユニークID
external_deliver_id_contents

説明

status=trueで、keitai_pc要素が無い場合は、ケータイ動画・音声が作成されていない。(エラーではない)

ステータス

有効

`POST` : `/contents/modify_video_keitai_info`

概要

動画・音声のケータイ情報を変更。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
keitaimeta_name	名前
keitaimeta_description	説明文
keitaimeta_author	作成者
keitaimeta_copyright	コピーライト

ステータス

有効

`POST` : `/contents/modify_video_keitai_encoding`

概要

ケータイ動画・音声を再変換。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
encoding_quality (required)	品質(ケータイ)
keitai_thumbnailattime	サムネイル画像とする時間を正の整数で秒指定が可能(デフォルト値3)
autocommit	自動公開設定・`0` : 手動で公開・`1` : 自動公開

ステータス

有効

`POST` : `/contents/delete_video_keitai`

概要

ケータイ動画・音声を削除。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID

ステータス

有効

`GET` : `/contents/get_video_youtube_details`

概要

動画・音声のYouTube詳細情報を取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列。

出力

レスポンス内容

名前(要素名)	値(要素の内容)
video_youtube	動画・音声YouTube要素
youtubemeta_name	名前
youtube_description	説明文
youtube_privacy_status	YouTube公開ステータス・`public` : 公開・`unlisted` : 限定公開・`private` : 非公開
process_status	コンテンツ登録ステータス
url	youtube上のurl
last_error

ステータス

有効

`POST` : `/contents/modify_video_youtube_info`

概要

動画・音声のYouTube情報を変更。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID
youtubemeta_name	名前
youtubemeta_description	説明文
youtube_privacy_status	YouTube公開ステータス・`public` : 公開・`unlisted` : 限定公開・`private` : 非公開

ステータス

有効

`POST` : `/contents/delete_video_youtube`

概要

YouTube動画・音声を削除。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID

ステータス

有効

`GET` : `/contents/get_video_common_details`

概要

動画・音声のcommon詳細情報を取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
ticket (required)	loginメソッドで取得できるチケット文字列
id_contents (required)	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
video_common	動画・音声common要素(PC/スマホ)
process_status	コンテンツ登録ステータス・`done` : オリジナル情報を取得可能・`idle`,`processing` : オリジナル情報を取得不可能
id_recipe	エンコード設定のID settings/list_recipeもしくは管理画面「トランスコード設定」の一覧よりご確認ください。
deliver_pc_nt (非推奨)	PC用エンコード設定・`0` : エンコード有り・`1` : エンコード無し ※【注意】エンコードがされていない動画に関しましてはサポートしかねます
deliver_sp_nt (非推奨)	SP用エンコード設定・`0` : エンコード有り・`1` : エンコード無し ※【注意】エンコードがされていない動画に関しましてはサポートしかねます
gid	コンテンツユニークID
external_deliver_id_contents
recipeconfig
option	オプション
format	フォーマット
codec	コーデック
bitrate	ビットレート
width	横幅
height	高さ
fps	フレームレート
audiocodec	オーディオコーデック
audiobitrate	オーディオビットレート
video	動画設定
secure	セキュア・`0` : なし・`1` : 暗号化
onetime	ワンタイム・`0` : なし・`1` : ワンタイム
rtmp	RTMP ・`0` : なし・`1` : RTMP(Flash)
hls	HLS ・`0` : なし・`1` : HTTP Live Streaming
http	HTTP ・`0` : なし・`1` : HTTP Progressive

説明

status=trueで、video_common要素が無い場合は、common動画・音声が作成されていない。(エラーではない)

ステータス

有効

目次

POST : /contents/modify_contents_info

概要

カテゴリ

入力

ステータス

GET : /contents/get_video_details

概要

カテゴリ

入力

出力

ステータス

POST : /contents/modify_video_info

概要

カテゴリ

入力

ステータス

GET : /contents/get_image_details

概要

カテゴリ

入力

出力

ステータス

POST : /contents/modify_image_info

概要

カテゴリ

入力

ステータス

GET : /contents/get_video_thumbnails

概要

カテゴリ

入力

出力

ステータス

POST : /contents/set_video_thumbnail

概要

カテゴリ

入力

ステータス

GET : /contents/download_original

概要

カテゴリ

入力

出力

備考

ステータス

GET : /contents/get_pdf_details

概要

カテゴリ

入力

出力

ステータス

POST : /contents/modify_pdf_info

概要

カテゴリ

入力

ステータス

POST : /contents/replace_contents

概要

カテゴリ

入力

ステータス

GET : /contents/get_preview_url

概要

カテゴリ

入力

出力

ステータス

POST : /contents/delete_thumbnail

概要

カテゴリ

入力

説明

ステータス

GET : /contents/get_video_keitai_details

概要

カテゴリ

入力

出力

説明

`POST` : `/contents/modify_contents_info`

`GET` : `/contents/get_video_details`

`POST` : `/contents/modify_video_info`

`GET` : `/contents/get_image_details`

`POST` : `/contents/modify_image_info`

`GET` : `/contents/get_video_thumbnails`

`POST` : `/contents/set_video_thumbnail`

`GET` : `/contents/download_original`

`GET` : `/contents/get_pdf_details`

`POST` : `/contents/modify_pdf_info`

`POST` : `/contents/replace_contents`

`GET` : `/contents/get_preview_url`

`POST` : `/contents/delete_thumbnail`

`GET` : `/contents/get_video_keitai_details`

`POST` : `/contents/modify_video_keitai_info`

`POST` : `/contents/modify_video_keitai_encoding`

`POST` : `/contents/delete_video_keitai`

`GET` : `/contents/get_video_youtube_details`

`POST` : `/contents/modify_video_youtube_info`

`POST` : `/contents/delete_video_youtube`

`GET` : `/contents/get_video_common_details`