REST Resource: advertisers.youtubeAdGroupAds

资源：Youtube 广告组广告

与 YouTube 广告组相关联的单个广告。

JSON 表示法 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
字段
name

string

广告的资源名称。
advertiserId

string (int64 format)

广告所属的广告客户的唯一 ID。
adGroupAdId

string (int64 format)

广告的唯一 ID。由系统分配。
adGroupId

string (int64 format)

广告所属广告组的唯一 ID。
displayName

string

广告的显示名称。

必须采用 UTF-8 编码，大小上限为 255 个字节。
entityStatus

enum (EntityStatus)

广告的实体状态。
adUrls[]

object (AdUrl)

广告使用的网址的列表。
联合字段 ad_details。广告的详细信息。ad_details 只能是下列其中一项：
displayVideoSourceAd

object (DisplayVideoSourceAd)

源自 Display & Video 360 广告素材的广告的详细信息。
mastheadAd

object (MastheadAd)

在 YouTube 首页动态中投放的广告的详细信息。
inStreamAd

object (InStreamAd)

5 秒钟后可跳过的插播广告的详细信息，用于提高品牌认知度或实现营销目标。
nonSkippableAd

object (NonSkippableAd)

不可跳过的插播视频广告的详细信息，时长介于 6 到 15 秒之间，用于实现营销目标。
bumperAd

object (BumperAd)

不可跳过的短视频广告的详细信息，时长不超过 6 秒，用于扩大覆盖面。
audioAd

object (AudioAd)

用于实现营销目标的音频广告的详细信息。
videoDiscoverAd

object (VideoDiscoveryAd)

在视频发现位置展示的视频宣传广告的详细信息。
videoPerformanceAd

object (VideoPerformanceAd)

行动号召视频广告系列中用于吸引用户对业务、服务或产品采取行动的广告的详细信息。

DisplayVideoSourceAd

来自 DV360 广告素材的广告。

JSON 表示法 
{
  "creativeId": string
}
字段
creativeId

string (int64 format)

源广告素材的 ID。

MastheadAd

标头广告的详细信息。

JSON 表示法 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
字段
video

object (YoutubeVideoDetails)

广告使用的 YouTube 视频。
headline

string

广告的标题。
description

string

广告的广告内容描述。
videoAspectRatio

enum (VideoAspectRatio)

标头广告上自动播放的 YouTube 视频的宽高比。
autoplayVideoStartMillisecond

string (int64 format)

视频开始播放前的时长（以毫秒为单位）。
autoplayVideoDuration

string (Duration format)

视频自动播放的时长。

此时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
callToActionButtonLabel

string

号召性用语按钮上的文字。
callToActionFinalUrl

string

号召性用语按钮的目标网址。
callToActionTrackingUrl

string

号召性用语按钮的跟踪网址。
showChannelArt

boolean

设置显示在 YouTube 页面顶部的背景还是横幅。
companionYoutubeVideos[]

object (YoutubeVideoDetails)

在桌面设备上的标头广告旁边显示的视频。不得超过 2 个。

YoutubeVideoDetails

YouTube 视频的详细信息。

JSON 表示法 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
字段
id

string

可在 YouTube 网页上搜索的 YouTube 视频 ID。
unavailableReason

enum (VideoUnavailableReason)

视频数据不可用的原因。

VideoUnavailableReason

可能导致视频无法播放的原因。

枚举
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED 未知或未指定。
VIDEO_UNAVAILABLE_REASON_PRIVATE 该视频是私享的。
VIDEO_UNAVAILABLE_REASON_DELETED 视频已被删除。

VideoAspectRatio

YouTube 视频的可能宽高比。

枚举
VIDEO_ASPECT_RATIO_UNSPECIFIED 未指定或未知。
VIDEO_ASPECT_RATIO_WIDESCREEN 视频被拉伸，顶部和底部被剪裁。
VIDEO_ASPECT_RATIO_FIXED_16_9 视频使用固定的 16:9 宽高比。

InStreamAd

插播广告的详细信息。

JSON 表示法 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
字段
commonInStreamAttribute

object (CommonInStreamAttribute)

常见广告属性。
customParameters

map (key: string, value: string)

用于将自定义值传递给跟踪网址模板的自定义参数。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

CommonInStreamAttribute

插播广告、不可跳过式广告和导视广告的常用属性。

JSON 表示法 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
字段
displayUrl

string

随广告一同展示的网址。
finalUrl

string

用户点击广告后到达的网页的网址。
trackingUrl

string

为了进行跟踪而在后台加载的网址。
actionButtonLabel

string

号召性用语按钮上的文字。
actionHeadline

string

号召性用语横幅的标题。
video

object (YoutubeVideoDetails)

广告的 YouTube 视频。
companionBanner

object (ImageAsset)

在视频广告旁边显示的图片。

ImageAsset

图片资源的元数据。

JSON 表示法 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
字段
mimeType

string

图片资源的 MIME 类型。
fullSize

object (Dimensions)

此图片以原始大小显示的元数据。
fileSize

string (int64 format)

图片资源的文件大小（以字节为单位）。

NonSkippableAd

不可跳过的广告的详细信息。

JSON 表示法 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
字段
commonInStreamAttribute

object (CommonInStreamAttribute)

常见广告属性。
customParameters

map (key: string, value: string)

用于将自定义值传递给跟踪网址模板的自定义参数。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

BumperAd

导视广告的详细信息。

JSON 表示法 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
字段
commonInStreamAttribute

object (CommonInStreamAttribute)

常见广告属性。

AudioAd

音频广告的详细信息。

JSON 表示法 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
字段
displayUrl

string

随广告一同展示的网址。
finalUrl

string

用户点击广告后到达的网页的网址。
trackingUrl

string

为了进行跟踪而在后台加载的网址。
video

object (YoutubeVideoDetails)

广告的 YouTube 视频。

VideoDiscoveryAd

视频发现广告的详细信息。

JSON 表示法 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
字段
headline

string

广告的标题。
description1

string

广告的第一行文字。
description2

string

广告的第二行文字。
video

object (YoutubeVideoDetails)

广告所宣传的 YouTube 视频。
thumbnail

enum (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 (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
字段
finalUrl

string

用户点击广告后到达的网页的网址。
trackingUrl

string

为了进行跟踪而在后台加载的网址。
actionButtonLabels[]

string

号召性用语按钮上显示的文字素材资源列表。
headlines[]

string

号召性用语横幅上显示的标题列表。
longHeadlines[]

string

号召性用语横幅上显示的单独标题列表。
descriptions[]

string

号召性用语横幅上显示的说明列表。
displayUrlBreadcrumb1

string

显示网址中域名之后的第一部分内容。
displayUrlBreadcrumb2

string

显示网址中域名之后的第二部分。
domain

string

显示网址的域名。
videos[]

object (YoutubeVideoDetails)

此广告使用的 YouTube 视频素材资源的列表。
customParameters

map (key: string, value: string)

用于将自定义值传递给跟踪网址模板的自定义参数。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
companionBanners[]

object (ImageAsset)

此广告使用的随播横幅广告的列表。

AdUrl

与广告相关的其他网址（包括信标）。

JSON 表示法 
{
  "type": enum (AdUrlType),
  "url": string
}
字段
type

enum (AdUrlType)

广告网址的类型。
url

string

网址字符串值。

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 操作的跟踪网址。

方法

get

 获取 YouTube 广告组广告。

list

 列出 YouTube 广告组广告。