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

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形式)
出力される値はこちらのリンクをご参照ください。
※元ファイルに存在する場合のみ出力されます。
元ファイルに出力可能な値が一つも存在しない場合は空文字が出力されますのでご注意ください。
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形式)
出力される値はこちらのリンクをご参照ください。
※元ファイルに存在する場合のみ出力されます。
元ファイルに出力可能な値が一つも存在しない場合は空文字が出力されますのでご注意ください。
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_infor

概要

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

カテゴリ

コンテンツ

入力

クエリー

名前
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_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動画・音声が作成されていない。(エラーではない)

ステータス

有効

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています