- リソース: VideoContent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- VideoContentStatus
- メタデータ
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- GracenoteMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- VideoContentSyndicationInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- SyndicatedVideoContentNames
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- DynamicAdInsertionInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- VideoIngestUrlInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- VideoFormat
- VideoPreconditioned
- ClosedCaptionUrlInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ClosedCaptionFormat
- メソッド
リソース: VideoContent
コンテンツのメタデータ。
JSON 表現 |
---|
{ "name": string, "status": enum ( |
フィールド | |
---|---|
name |
出力専用。動画コンテンツのリソース名。このフィールドの形式は、networks/{network_code}/sources/{content_source_id}/content/{cms_content_id} です。 network_code は、このコンテンツが属する Google アド マネージャーのネットワーク コードです。 content_source_id は、このコンテンツが属する Google アド マネージャーのコンテンツ ソース ID です。 cms_content_id は Google アド マネージャーの CMS コンテンツ ID で、該当する動画に対してアド マネージャーで配信できる広告を識別するために広告リクエストの一部として形成されます。この値は、数字または英数字です。 |
status |
コンテンツのステータス。これを省略すると、デフォルト値が有効になります。 |
title |
必須。コンテンツのタイトル。 |
updateTime |
必須。コンテンツの最終更新日時。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
publishTime |
コンテンツの公開時刻。動画が広告ルールに含まれるように設計されている場合、開始時間と終了時間は必須項目です。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
duration |
コンテンツの再生時間。期間は、ミリ秒単位までサポートされます。
|
cuePoints[] |
キューポイントを指定します。キューポイントは、動画内で広告を挿入できるタイミングです。キューポイントはミリ秒単位までサポートされます。動画にミッドロール挿入点が含まれる場合、これは必須フィールドです。
|
thumbnailUrl |
コンテンツのサムネイル URL。 |
metadata |
コンテンツのカスタム メタデータを指定します。 |
gracenoteMetadata |
コンテンツの Gracenote 関連のメタデータ。 |
syndicationMetadata |
コンテンツのシンジケーション関連のメタデータ。 |
dynamicAdInsertionMetadata |
ダイナミック広告挿入に関連するコンテンツのメタデータ。 |
VideoContentStatus
コンテンツのターゲット広告を配信するかどうかを示すステータス オプション。
列挙型 | |
---|---|
ACTIVE |
コンテンツ ターゲット広告が配信されます。 |
BLOCKED |
ステータスが「ブロック」の場合、このコンテンツには広告は配信されません。 |
DELETED |
コンテンツはアド マネージャーでアーカイブされます。「削除済み」のマークが付いたコンテンツの広告リクエストがアド マネージャーで届いた場合は、自社広告や、広告枠ユニットや他のターゲティング条件をターゲットとしている広告が配信されます。広告をブロックするには、ステータスを [ブロック] に設定します。 |
メタデータ
コンテンツのカスタム メタデータ。
JSON 表現 |
---|
{ "keyValues": { string: value, ... } } |
フィールド | |
---|---|
keyValues |
コンテンツのカスタム メタデータを Key-Value ペアとして識別します。値に指定できるのは、文字列または文字列のリストのみです。 |
GracenoteMetadata
コンテンツの Gracenote メタデータ。
JSON 表現 |
---|
{ "gracenoteId": string, "gracenoteSeriesId": string } |
フィールド | |
---|---|
gracenoteId |
必須。コンテンツの Gracenote ID を参照します。次のいずれかの有効なプレフィックスを指定する必要があります。1.「EP」- シリーズ 2 のエピソード。「MV」- ムービー 3。「SP」- スポーツ イベント |
gracenoteSeriesId |
省略可。このフィールドは、Gracenote シリーズ ID を参照します。先頭に「SH」を付ける必要があります。 |
VideoContentSyndicationInfo
正規コンテンツとシンジケーション コンテンツの関係を指定するためのメタデータ。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド syndication 。VideoContentSyndiationMetadata には、次のいずれかのみを含めることができます。syndication は次のいずれかになります。 |
|
canonicalVideoContent |
正規コンテンツの名前。「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」の形式にする必要があります。このフィールドを含むコンテンツと同じネットワークに属している必要があります。 |
syndicatedVideoContentNames |
シンジケーション コンテンツのコレクション |
SyndicatedVideoContentNames
すべてのシンジケーション コンテンツの名前のリスト。
JSON 表現 |
---|
{ "syndicatedVideoContent": [ string ] } |
フィールド | |
---|---|
syndicatedVideoContent[] |
シンジケーション コンテンツの名前の繰り返しフィールド。「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」の形式である必要があります。このフィールドを含むコンテンツと同じネットワークに属している必要があります。 |
DynamicAdInsertionInfo
ダイナミック広告挿入に関する情報です。
JSON 表現 |
---|
{ "videoIngestUrlInfo": { object ( |
フィールド | |
---|---|
videoIngestUrlInfo |
条件付けやプレイリストの生成に使用されるマスター m3u8 ファイルへのリンク。 |
mediaUpdateTime |
videoIngestUrlInfo で参照されている動画ファイルの最終更新日時。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
closedCaptionUrlInfo[] |
字幕ファイルの URL。 |
fwCaid |
広告のターゲティングに使用される Freewheel カスタム アセット ID。 |
VideoIngestUrlInfo
条件付けと再生リストの生成に使用される m3u8 ファイルへのリンクを指定するメタデータ。
JSON 表現 |
---|
{ "videoFormat": enum ( |
フィールド | |
---|---|
videoFormat |
動画の形式。 |
videoPreconditioned |
コンテンツがミッドロール広告用に条件付けられている(つまり、ミッドロール挿入点の時点でセグメントがすでに分割されている)かどうかを示す。 |
url |
m3u8 ファイルへのリンク。 |
VideoFormat
動画コンテンツをエンコードできる形式。
列挙型 | |
---|---|
VIDEO_FORMAT_UNSPECIFIED |
動画形式が指定されていません。 |
HLS |
application/x-mpegURL |
DASH |
application/dash+xml |
VideoPreconditioned
動画コンテンツの条件付け状態。
列挙型 | |
---|---|
NO |
まだ条件付けされていません。 |
YES |
動画には条件付け/スプライス加工が施されています。 |
ClosedCaptionUrlInfo
1 つの字幕ファイルのメタデータ。
JSON 表現 |
---|
{
"languageCode": string,
"closedCaptionFormat": enum ( |
フィールド | |
---|---|
languageCode |
字幕ファイルで使用されている言語を表す IETF BCP-47 言語コード。 |
closedCaptionFormat |
字幕ファイルの形式。 |
url |
字幕ファイルの URL。 |
ClosedCaptionFormat
字幕ファイルの形式。
列挙型 | |
---|---|
CLOSED_CAPTION_FORMAT_UNSPECIFIED |
字幕の形式が指定されていません。 |
TTML |
application/ttaf+xml |
WEB_VTT |
text/vtt |
メソッド |
|
---|---|
|
新しいコンテンツを作成したり、コンテンツがすでにアド マネージャーに存在する場合はメタデータを更新したりするための API。 |