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)

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

小数点以下 9 桁までで、末尾が 's' の秒数。例: "3.5s"
cuePoints[]

string (Duration format)

キューポイントを指定します。キューポイントとは、動画内に広告を挿入できる位置のことです。キューポイントはミリ秒レベルまでサポートされています。動画にミッドロール広告ブレークが含まれている場合、これは必須項目です。

小数点以下 9 桁までで、末尾が 's' の秒数。例: "3.5s"
thumbnailUrl

string

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

object (Metadata)

コンテンツのカスタム メタデータを識別します。
gracenoteMetadata

object (GracenoteMetadata)

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

object (VideoContentSyndicationInfo)

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

object (DynamicAdInsertionInfo)

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

動画コンテンツのステータス

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

列挙型
ACTIVE コンテンツ ターゲット広告が表示されます。
BLOCKED ステータスが「BLOCKED」の場合、このコンテンツには広告が表示されません。
DELETED コンテンツはアド マネージャーでアーカイブされます。アド マネージャーが、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)

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

SyndicatedVideoContentName

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

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

string

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

ダイナミック広告挿入情報

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

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

広告のターゲットに使用するフリーホイールのカスタム アセット ID。

VideoIngestUrl 情報

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

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

enum (VideoFormat)

動画の形式。
videoPreconditioned

enum (VideoPreconditioned)

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

string

m3u8 ファイルへのリンク。

動画フォーマット

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

列挙型
VIDEO_FORMAT_UNSPECIFIED 動画フォーマットが指定されていません。
HLS application/x-mpegURL
DASH application/dash+xml

動画事前の条件付け

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

列挙型
NO まだ調整されていません。
YES 動画の状態調整やコメント

クローズド キャプション URL 情報

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

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

string

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

enum (ClosedCaptionFormat)

字幕ファイルの形式。
url

string

字幕ファイルの URL です。

クローズド キャプション フォーマット

字幕ファイルの形式。

列挙型
CLOSED_CAPTION_FORMAT_UNSPECIFIED 字幕フォーマットが指定されていません。
TTML application/ttaf+xml
WEB_VTT テキスト/vtt

Methods

update

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