contents(コンテンツ2：詳細情報、変更)

contents/modify_contents_info

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
name	名前(省略可)
description	説明文(省略可)
metatag	タグ(省略可)
visible	1=常に表示。0=常に非表示。DATE,DATE=期間公開。

ステータス

有効

 

contents/get_video_details

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
video	動画・音声情報
name	コンテンツ名
description	説明文
metatag	メタタグ
meta_url	メタurl
visible	1=常に表示、0=常に非表示、DATE,DATE=期間公開。
create_date	投稿日時
update_date	更新日
duration	再生時間
original_filename	元動画・元音声のファイル名
original_format	元動画・元音声のフォーマット
original_filesize	元動画・元音声のファイルサイズ
original_width	元動画の幅
original_height	元動画の高さ
original_exif	元動画・元音声のexif情報（JSON形式） 出力される値はこちらのリンクをご参照ください。 ※元ファイルに存在する場合のみ出力されます。   元ファイルに出力可能な値が一つも存在しない場合は空文字が出力されますのでご注意ください。
process_status	コンテンツ登録ステータス(idle,processingの場合、サムネイルやオリジナル情報が取得出来ない)
id_video_thumbnail	サムネイルID
gid	コンテンツユニークID
usermeta	USERMETA ※未指定時は空文字
id_recipe	エンコード設定のID settings/list_recipeもしくは管理画面「トランスコード設定」の一覧よりご確認ください。

ステータス

有効

 

contents/modify_video_info

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
name	コンテンツ名(省略可)
description	説明文(省略可)
metatag	タグ(省略可)
meta_url	メタURL(省略可)
visible	1=常に表示。0=常に非表示。DATE,DATE=期間公開。
update_date	更新日(省略可)※未使用
usermeta	USERMETA(省略可)
opt_related_image	関連画像(省略可)　※画像ファイルのid_contentsを指定。

ステータス

有効

 

contents/get_image_details

概要

画像の詳細情報を取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
image	画像情報
name	コンテンツ名
description	説明文
metatag	メタタグ
meta_url	メタurl(広告用)
visible	1=常に表示、0=常に非表示、DATE,DATE=期間公開。
create_date	投稿日時
original_filename	元画像のファイル名
original_format	元画像のフォーマット
original_filesize	元画像のファイルサイズ
original_width	元画像の幅
original_height	元画像の高さ
original_exif	元画像のexif情報（JSON形式） 出力される値はこちらのリンクをご参照ください。 ※元ファイルに存在する場合のみ出力されます。   元ファイルに出力可能な値が一つも存在しない場合は空文字が出力されますのでご注意ください。
process_status	コンテンツ登録ステータス(idle,processingの場合、サムネイルやオリジナル情報が取得出来ない)
gid	コンテンツユニークID

ステータス

有効

 

contents/modify_image_info

概要

画像の情報を変更。

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
name	コンテンツ名(省略可)
description	説明文(省略可)
metatag	タグ(省略可)
meta_url	メタURL(広告用)(省略可)
visible	1=常に表示。0=常に非表示。DATE,DATE=期間公開。

ステータス

有効

 

 

 

contents/get_urls

概要

コンテンツのURLを取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
original	元動画・元音声URL ※このファイルURLは絶対に配信利用しないでください。
sources	変換後URLリスト

ステータス

有効

 

 

contents/get_video_thumbnails

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
thumbnail	サムネイル(※リスト)
id_video_thumbnail	サムネイルID
url	URL
selected	現在選択されている場合は1、それ以外は0

ステータス

有効

 

contents/set_video_thumbnail

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
id_video_thumbnail	サムネイルID
autocommit	1を指定した場合、設定完了後に自動公開処理を行う

ステータス

有効

 

contents/download_original

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID

出力

元動画・元音声・画像・PDFのデータ
※Content-Dispositionレスポンスヘッダにファイル名が含まれます。

備考

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

ステータス

有効

 

contents/get_pdf_details

概要

PDFの詳細情報を取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
pdf	PDF情報
name	コンテンツ名
description	説明文
metatag	メタタグ
visible	1=常に表示、0=常に非表示、DATE,DATE=期間公開。
create_date	投稿日時
update_date	更新日
original_filename	元PDFのファイル名
original_format	元PDFのフォーマット
original_filesize	元PDFのファイルサイズ
process_status	コンテンツ登録ステータス
gid	コンテンツユニークID
usermeta	USERMETA ※未指定時は空文字
domaincontrol	ドメイン制御
urls	PDF画像URL一覧カンマ区切り文字列
totalpage	ページ数

ステータス

有効

 

contents/modify_pdf_info

概要

PDF情報を編集。

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
name	コンテンツ名(省略可)
description	説明(省略可)
metatag	タグ(省略可)
visible	1=常に表示。0=常に非表示。DATE,DATE=期間公開。(省略可)
update_date	更新日(省略可)※未使用
usermeta	USERMETA(省略可)
domaincontrol	ドメイン制御(省略可)

ステータス

有効

 

 

contents/replace_contents

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
filekey	ファイルキー
pc_nt	1を指定した場合、PC向け配信用動画として元動画をそのまま利用します(元動画がmp4/flv/f4vファイルのときのみ) ※ ただしflv,f4vはhtml5プレイヤーに対応しておりません。
sp_nt	1を指定した場合、SP向け配信用動画として元動画をそのまま利用します(元動画がmp4ファイルのときのみ)
autocommit	1を指定した場合、変換完了後に自動公開処理を行う

ステータス

有効

 

contents/get_preview_url

概要

プレビュー用コンテンツURLを取得。

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
url	プレビュー用のコンテンツのURL
urls	プレビュー用のPDF画像URL一覧カンマ区切り文字列 ※type=PDFのときのみ

ステータス

有効

 

contents/delete_thumbnail

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
id_video_thumbnail	サムネイルID

説明

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

ステータス

有効

 

 

 

 

contents/get_video_keitai_details

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
count	countが指定された場合、 出力のurlがワンタイムURLを発行するためのURLになります。 ワンタイムURLは指定された回数だけコンテンツの閲覧が可能になります。 ※1 以上 999 以下の時ワンタイム化されます。   未指定、0以下は回数制限されません。 ※フィーチャーフォンワンタイムURLを契約済みのお客様のみ利用可能です。

出力

レスポンス内容

名前(要素名)	値(要素の内容)
video_keitai	動画・音声ケータイ要素
keitaimeta_name	名前
keitaimeta_descriotion	説明文
keitaimeta_author	作成者
keitaimeta_copyright	コピーライト
process_status	コンテンツ登録ステータス
encoding_quality	品質(ケータイ)
url	URL countが指定された場合、 ワンタイムURLを発行するためのURLになります。

説明

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

ステータス

有効

 

contents/modify_video_keitai_info

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
keitaimeta_name	名前
keitaimeta_description	説明文(省略可)
keitaimeta_author	作成者(省略可)
keitaimeta_copyright	コピーライト(省略可)

ステータス

有効

 

 

contents/modify_video_keitai_encoding

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID
encoding_quality	品質(ケータイ)
keitai_thumbnailattime	サムネイル画像とする時間を正の整数で秒指定が可能(省略可:デフォルト値3)
autocommit	1を指定した場合、変換完了後に自動公開処理を行う (省略可能だが、その場合は管理画面上での[公開]処理が必要となるため、APIで完結させるべく利用を強く推奨)

ステータス

有効

 

contents/delete_video_keitai

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID

ステータス

有効

 

contents/get_video_common_details

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前	値
id_contents	コンテンツID

出力

レスポンス内容

名前(要素名)	値(要素の内容)
video_common	動画・音声common要素(PC/スマホ)
process_status	コンテンツ登録ステータス
id_recipe	エンコード設定のID 設定内容はsettings/list_recipeもしくは管理画面「トランスコード設定」の一覧よりご確認ください。
deliver_pc_nt	1: エンコード無し / 0: エンコード有り
recipeconfig	recipeconfig

説明

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

ステータス

有効