REST Resource: videoAdvertisingOptions

资源：VideoAdvertisingOption

视频的广告设置。这些设置用于确定可以在视频播放期间投放的广告类型，以及允许在视频播放期间投放广告的时间。

JSON 表示法 
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
字段
kind

string

API 资源的类型。对于此资源，该值为 youtubePartner#videoAdvertisingOption。
adFormats[]

string

视频允许展示的广告格式列表。注意：自 2023 年 11 月起，只能在此列中启用/停用 thirdParty。如需了解详情，请参阅支持文章。以下广告格式控件已不再可用，不应包含在 API 请求中：instream_standard、display、preroll、postroll。
breakPosition[]

string

视频播放期间广告插播的时刻。
adBreaks[]

object (AdBreak)

一个时间点列表，表示 YouTube 可以在视频播放期间展示插播广告的时间。
autoGeneratedBreaks

boolean

为此视频启用自动生成的中贴片广告插播时间点。如果在已定义 adBreaks 的视频中将 autoGeneratedBreaks 设置为 true，除了手动放置的广告位之外，我们的系统还会确定广告展示位置。
id

string

YouTube 用于唯一标识与广告设置相关联的视频的 ID。
tpAdServerVideoId

string

一个独一无二的值，以便第三方广告服务器能够识别出视频。
tpTargetingUrl

string

第三方广告服务器的基准网址，YouTube 可以从中检索视频的插播广告。
tpUrlParameters

string

要附加到发送给第三方广告服务器的请求末尾的参数字符串。

AdBreak

adBreak 资源包含有关 YouTube 可以在视频播放期间展示插播广告的时间的信息。

JSON 表示法 
{
  "position": string,
  "midrollSeconds": integer
}
字段
position

string

视频播放期间广告插播的时刻。
midrollSeconds

integer

广告插播时间，以视频开始播放后广告插播发生时所经过的秒数表示。

方法

get

 检索指定视频的广告设置。

getEnabledAds

 检索指定合作伙伴或用户上传的视频允许投放的广告类型的详细信息。

patch

 修补指定视频的广告设置。

update

 更新指定视频的广告设置。