- 资源:YoutubeAdGroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- 缩略图
- VideoPerformanceAd
- AdUrl
- AdUrlType
- 方法
资源:YoutubeAdGroupAd
与 YouTube 广告组相关联的单个广告。
| JSON 表示法 | 
|---|
| { "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum ( | 
| 字段 | |
|---|---|
| name | 
 广告的资源名称。 | 
| advertiserId | 
 广告所属广告客户的唯一 ID。 | 
| adGroupAdId | 
 广告的唯一 ID。由系统分配。 | 
| adGroupId | 
 广告所属广告组的唯一 ID。 | 
| displayName | 
 广告的显示名称。 必须采用 UTF-8 编码,大小不得超过 255 字节。 | 
| entityStatus | 
 广告的实体状态。 | 
| adUrls[] | 
 广告使用的网址列表。 | 
| 联合字段 ad_details。广告的详细信息。ad_details只能是下列其中一项: | |
| displayVideoSourceAd | 
 来自展示广告网络的广告的详情Video 360 广告素材。 | 
| mastheadAd | 
 在 YouTube 首页动态中投放的广告的详细信息。 | 
| inStreamAd | 
 5 秒后可跳过的插播广告的详细信息,用于实现品牌认知度或覆盖面营销目标。 | 
| nonSkippableAd | 
 用于覆盖面营销目标的不可跳过的插播广告详情(时长介于 6-15 秒之间)。 | 
| bumperAd | 
 不可跳过的短视频广告的详细信息,时长等于或短于 6 秒,用于覆盖面。 | 
| audioAd | 
 用于实现营销目标的音频广告的详细信息。 | 
| videoDiscoverAd | 
 在发现途径中展示的宣传视频的广告的详细信息。 | 
| videoPerformanceAd | 
 行动号召视频广告系列中使用的广告的详细信息,旨在吸引用户针对您的业务、服务或产品采取行动。 | 
DisplayVideoSourceAd
源自 DV360 广告素材的广告。
| JSON 表示法 | 
|---|
| { "creativeId": string } | 
| 字段 | |
|---|---|
| creativeId | 
 来源广告素材的 ID。 | 
MastheadAd
标头广告的详细信息。
| JSON 表示法 | 
|---|
| { "video": { object ( | 
| 字段 | |
|---|---|
| video | 
 广告使用的 YouTube 视频。 | 
| headline | 
 广告的标题。 | 
| description | 
 广告的说明。 | 
| videoAspectRatio | 
 标头广告上自动播放的 YouTube 视频的宽高比。 | 
| autoplayVideoStartMillisecond | 
 视频开始播放所需的毫秒数。 | 
| autoplayVideoDuration | 
 视频自动播放的时长。 该时长以秒为单位,最多包含九个小数位,以“ | 
| callToActionButtonLabel | 
 号召性用语按钮上的文字。 | 
| callToActionFinalUrl | 
 号召性用语按钮的目标网址。 | 
| callToActionTrackingUrl | 
 号召性用语按钮的跟踪网址。 | 
| showChannelArt | 
 是在 YouTube 页面顶部显示背景还是横幅。 | 
| companionYoutubeVideos[] | 
 在桌面设备上的标头广告旁边显示的视频。不得超过两个。 | 
YoutubeVideoDetails
YouTube 视频的详细信息。
| JSON 表示法 | 
|---|
| {
  "id": string,
  "unavailableReason": enum ( | 
| 字段 | |
|---|---|
| id | 
 可在 YouTube 网页上搜索的 YouTube 视频 ID。 | 
| unavailableReason | 
 视频数据不可用的原因。 | 
VideoAspectRatio
可能的 YouTube 视频宽高比。
| 枚举 | |
|---|---|
| VIDEO_ASPECT_RATIO_UNSPECIFIED | 未指定或未知。 | 
| VIDEO_ASPECT_RATIO_WIDESCREEN | 视频会被拉伸,并且顶部和底部会被剪裁。 | 
| VIDEO_ASPECT_RATIO_FIXED_16_9 | 视频使用 16:9 的固定宽高比。 | 
InStreamAd
插播广告的详细信息。
| JSON 表示法 | 
|---|
| {
  "commonInStreamAttribute": {
    object ( | 
| 字段 | |
|---|---|
| commonInStreamAttribute | 
 常见广告属性。 | 
| customParameters | 
 用于将自定义值传递给跟踪网址模板的自定义参数。 包含一系列  | 
CommonInStreamAttribute
插播广告、不可跳过的广告和导视广告的常见属性。
| JSON 表示法 | 
|---|
| { "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( | 
| 字段 | |
|---|---|
| displayUrl | 
 随广告一同展示的网址。 | 
| finalUrl | 
 用户点击广告后到达的网页的网址。 | 
| trackingUrl | 
 在后台加载的网址地址,用于跟踪目的。 | 
| actionButtonLabel | 
 号召性用语按钮上的文字。 | 
| actionHeadline | 
 号召性用语横幅的标题。 | 
| video | 
 广告的 YouTube 视频。 | 
| companionBanner | 
 视频广告旁边显示的图片。 | 
ImageAsset
图片资源的元数据。
| JSON 表示法 | 
|---|
| {
  "mimeType": string,
  "fullSize": {
    object ( | 
| 字段 | |
|---|---|
| mimeType | 
 图片资源的 MIME 类型。 | 
| fullSize | 
 此图片原始大小的元数据。 | 
| fileSize | 
 图片资源的文件大小(以字节为单位)。 | 
NonSkippableAd
不可跳过的广告的详细信息。
| JSON 表示法 | 
|---|
| {
  "commonInStreamAttribute": {
    object ( | 
| 字段 | |
|---|---|
| commonInStreamAttribute | 
 常见广告属性。 | 
| customParameters | 
 用于将自定义值传递给跟踪网址模板的自定义参数。 包含一系列  | 
BumperAd
导视广告的详细信息。
| JSON 表示法 | 
|---|
| {
  "commonInStreamAttribute": {
    object ( | 
| 字段 | |
|---|---|
| commonInStreamAttribute | 
 常见的广告属性。 | 
AudioAd
音频广告的详细信息。
| JSON 表示法 | 
|---|
| {
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object ( | 
| 字段 | |
|---|---|
| displayUrl | 
 随广告一同展示的网址。 | 
| finalUrl | 
 用户点击广告后到达的网页的网址。 | 
| trackingUrl | 
 为进行跟踪而在后台加载的网址。 | 
| video | 
 广告的 YouTube 视频。 | 
VideoDiscoveryAd
视频发现广告的详细信息。
| JSON 表示法 | 
|---|
| { "headline": string, "description1": string, "description2": string, "video": { object ( | 
| 字段 | |
|---|---|
| headline | 
 广告的标题。 | 
| description1 | 
 广告的第一行文字。 | 
| description2 | 
 广告的第二行文字。 | 
| video | 
 广告宣传的 YouTube 视频。 | 
| thumbnail | 
 广告中使用的缩略图图片。 | 
缩略图
视频发现广告中可能显示的缩略图选项。
| 枚举 | |
|---|---|
| THUMBNAIL_UNSPECIFIED | 未知或未指定。 | 
| THUMBNAIL_DEFAULT | 默认缩略图可以自动生成,也可以由用户上传。 | 
| THUMBNAIL_1 | 缩略图 1,由视频生成。 | 
| THUMBNAIL_2 | 缩略图 2,由视频生成。 | 
| THUMBNAIL_3 | 缩略图 3,由视频生成。 | 
VideoPerformanceAd
视频效果广告的详细信息。
| JSON 表示法 | 
|---|
| { "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( | 
| 字段 | |
|---|---|
| finalUrl | 
 用户点击广告后到达的网页的网址。 | 
| trackingUrl | 
 为进行跟踪而在后台加载的网址。 | 
| actionButtonLabels[] | 
 号召性用语按钮上显示的文字素材资源列表。 | 
| headlines[] | 
 号召性用语横幅上显示的标题列表。 | 
| longHeadlines[] | 
 号召性用语横幅上显示的孤立标题列表。 | 
| descriptions[] | 
 号召性用语横幅上显示的说明列表。 | 
| displayUrlBreadcrumb1 | 
 显示网址中域名之后的第一部分。 | 
| displayUrlBreadcrumb2 | 
 显示网址中域名后面的第二部分。 | 
| domain | 
 显示网址的域名。 | 
| videos[] | 
 此广告使用的 YouTube 视频素材资源列表。 | 
| customParameters | 
 用于将自定义值传递给跟踪网址模板的自定义参数。 包含一系列  | 
| companionBanners[] | 
 此广告使用的随播横幅广告的列表。 | 
AdUrl
与广告相关的其他网址,包括信标。
| JSON 表示法 | 
|---|
| {
  "type": enum ( | 
| 字段 | |
|---|---|
| type | 
 广告网址的类型。 | 
| url | 
 网址字符串值。 | 
AdUrlType
可能的广告网址类型。
| 枚举 | |
|---|---|
| AD_URL_TYPE_UNSPECIFIED | 未知或未指定。 | 
| AD_URL_TYPE_BEACON_IMPRESSION | 在投放广告素材展示时执行 ping 的 1x1 跟踪像素。 | 
| AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION | 可扩展的 DCM 展示信标。在投放时,它会扩展为多个信标。 | 
| AD_URL_TYPE_BEACON_CLICK | 点击事件触发时要执行 ping 操作的跟踪网址。 | 
| AD_URL_TYPE_BEACON_SKIP | 在触发跳过事件时执行 ping 的跟踪网址。 | 
| 方法 | |
|---|---|
| 
 | 获取 YouTube 广告组广告。 | 
| 
 | 列出 YouTube 广告组广告。 |