REST Resource: videoContent.networks.sources.content

リソース: VideoContent

コンテンツのメタデータ。

JSON 表現
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
フィールド
name

string

出力専用。動画コンテンツのリソース名。このフィールドの形式は、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

enum (VideoContentStatus)

コンテンツのステータス。これを省略すると、デフォルト値が有効になります。

title

string

必須。コンテンツのタイトル。

updateTime

string (Timestamp format)

必須。コンテンツの最終更新日時。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

publishTime

string (Timestamp format)

コンテンツの公開時刻。動画が広告ルールに含まれるように設計されている場合、開始時間と終了時間は必須項目です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

duration

string (Duration format)

コンテンツの再生時間。期間は、ミリ秒単位までサポートされます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

cuePoints[]

string (Duration format)

キューポイントを指定します。キューポイントは、動画内で広告を挿入できるタイミングです。キューポイントはミリ秒単位までサポートされます。動画にミッドロール挿入点が含まれる場合、これは必須フィールドです。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

thumbnailUrl

string

コンテンツのサムネイル URL。

metadata

object (Metadata)

コンテンツのカスタム メタデータを指定します。

gracenoteMetadata

object (GracenoteMetadata)

コンテンツの Gracenote 関連のメタデータ。

syndicationMetadata

object (VideoContentSyndicationInfo)

コンテンツのシンジケーション関連のメタデータ。

dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

ダイナミック広告挿入に関連するコンテンツのメタデータ。

VideoContentStatus

コンテンツのターゲット広告を配信するかどうかを示すステータス オプション。

列挙型
ACTIVE コンテンツ ターゲット広告が配信されます。
BLOCKED ステータスが「ブロック」の場合、このコンテンツには広告は配信されません。
DELETED コンテンツはアド マネージャーでアーカイブされます。「削除済み」のマークが付いたコンテンツの広告リクエストがアド マネージャーで届いた場合は、自社広告や、広告枠ユニットや他のターゲティング条件をターゲットとしている広告が配信されます。広告をブロックするには、ステータスを [ブロック] に設定します。

メタデータ

コンテンツのカスタム メタデータ。

JSON 表現
{
  "keyValues": {
    string: value,
    ...
  }
}
フィールド
keyValues

map (key: string, value: value (Value format))

コンテンツのカスタム メタデータを Key-Value ペアとして識別します。値に指定できるのは、文字列または文字列のリストのみです。

GracenoteMetadata

コンテンツの Gracenote メタデータ。

JSON 表現
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
フィールド
gracenoteId

string

必須。コンテンツの Gracenote ID を参照します。次のいずれかの有効なプレフィックスを指定する必要があります。1.「EP」- シリーズ 2 のエピソード。「MV」- ムービー 3。「SP」- スポーツ イベント

gracenoteSeriesId

string

省略可。このフィールドは、Gracenote シリーズ ID を参照します。先頭に「SH」を付ける必要があります。

VideoContentSyndicationInfo

正規コンテンツとシンジケーション コンテンツの関係を指定するためのメタデータ。

JSON 表現
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
フィールド
共用体フィールド syndication。VideoContentSyndiationMetadata には、次のいずれかのみを含めることができます。syndication は次のいずれかになります。
canonicalVideoContent

string

正規コンテンツの名前。「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」の形式にする必要があります。このフィールドを含むコンテンツと同じネットワークに属している必要があります。

syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

シンジケーション コンテンツのコレクション

SyndicatedVideoContentNames

すべてのシンジケーション コンテンツの名前のリスト。

JSON 表現
{
  "syndicatedVideoContent": [
    string
  ]
}
フィールド
syndicatedVideoContent[]

string

シンジケーション コンテンツの名前の繰り返しフィールド。「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」の形式である必要があります。このフィールドを含むコンテンツと同じネットワークに属している必要があります。

DynamicAdInsertionInfo

ダイナミック広告挿入に関する情報です。

JSON 表現
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
フィールド
videoIngestUrlInfo

object (VideoIngestUrlInfo)

条件付けやプレイリストの生成に使用されるマスター m3u8 ファイルへのリンク。

mediaUpdateTime

string (Timestamp format)

videoIngestUrlInfo で参照されている動画ファイルの最終更新日時。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

字幕ファイルの URL。

fwCaid

string

広告のターゲティングに使用される Freewheel カスタム アセット ID。

VideoIngestUrlInfo

条件付けと再生リストの生成に使用される m3u8 ファイルへのリンクを指定するメタデータ。

JSON 表現
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
フィールド
videoFormat

enum (VideoFormat)

動画の形式。

videoPreconditioned

enum (VideoPreconditioned)

コンテンツがミッドロール広告用に条件付けられている(つまり、ミッドロール挿入点の時点でセグメントがすでに分割されている)かどうかを示す。

url

string

m3u8 ファイルへのリンク。

VideoFormat

動画コンテンツをエンコードできる形式。

列挙型
VIDEO_FORMAT_UNSPECIFIED 動画形式が指定されていません。
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

動画コンテンツの条件付け状態。

列挙型
NO まだ条件付けされていません。
YES 動画には条件付け/スプライス加工が施されています。

ClosedCaptionUrlInfo

1 つの字幕ファイルのメタデータ。

JSON 表現
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
フィールド
languageCode

string

字幕ファイルで使用されている言語を表す IETF BCP-47 言語コード。

closedCaptionFormat

enum (ClosedCaptionFormat)

字幕ファイルの形式。

url

string

字幕ファイルの URL。

ClosedCaptionFormat

字幕ファイルの形式。

列挙型
CLOSED_CAPTION_FORMAT_UNSPECIFIED 字幕の形式が指定されていません。
TTML application/ttaf+xml
WEB_VTT text/vtt

メソッド

update

新しいコンテンツを作成したり、コンテンツがすでにアド マネージャーに存在する場合はメタデータを更新したりするための API。