- 资源:AdGroupAd
- AdPolicy
- AdPolicyApprovalStatus
- AdPolicyReviewStatus
- AdPolicyTopicEntry
- AdPolicyTopicEntryType
- AdPolicyDecisionType
- AdPolicyEnforcementMeans
- AdPolicyTopicEvidence
- TextList
- WebsiteList
- DestinationTextList
- DestinationMismatch
- AdPolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
- 商标
- AdPolicyCriterionRestriction
- LegalRemoval
- Dmca
- LocalLegal
- AdPolicyTopicEvidenceLegalRemovalComplaintType
- 仿冒
- RegionalRequirements
- RegionalRequirementsEntry
- AdPolicyTopicConstraint
- AdPolicyCountryConstraintList
- AdPolicyResellerConstraint
- AdPolicyGlobalCertificateMissingConstraint
- AdPolicyGlobalCertificateDomainMismatchConstraint
- AdPolicyTopicAppealInfo
- AdPolicyAppealType
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- 缩略图
- VideoPerformanceAd
- AdUrl
- AdUrlType
- 方法
资源:AdGroupAd
与广告组关联的单个广告。
| JSON 表示法 | 
|---|
| { "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "adPolicy": { object ( | 
| 字段 | |
|---|---|
| name | 
 相应广告的资源名称。 | 
| advertiserId | 
 相应广告所属广告客户的唯一 ID。 | 
| adGroupAdId | 
 广告的唯一 ID。由系统分配。 | 
| adGroupId | 
 相应广告所属的广告组的唯一 ID。 | 
| displayName | 
 广告的显示名称。 必须采用 UTF-8 编码,大小上限为 255 字节。 | 
| adPolicy | 
 广告的政策审批状态。 | 
| entityStatus | 
 广告的实体状态。 | 
| adUrls[] | 
 广告使用的网址列表。 | 
| 联合字段  ad_details只能是下列其中一项: | |
| displayVideoSourceAd | 
 源自 Display & Video 360 广告素材的广告的详细信息。 | 
| mastheadAd | 
 在 YouTube 首页动态中投放的广告的详细信息。 | 
| inStreamAd | 
 展示 5 秒后可跳过的插播广告的详细信息,用于实现品牌认知度或覆盖面营销目标。 | 
| nonSkippableAd | 
 不可跳过的短插播视频广告(时长介于 6-15 秒之间)的详细信息,用于实现覆盖面营销目标。 | 
| bumperAd | 
 用于提升覆盖面的不可跳过的短视频广告(时长不超过 6 秒)的详细信息。 | 
| audioAd | 
 用于实现覆盖面营销目标的音频广告的详细信息。 | 
| videoDiscoverAd | 
 宣传视频的广告的详细信息,该广告会显示在发现位置。 | 
| videoPerformanceAd | 
 行动号召视频广告系列中使用的广告的详细信息,旨在吸引用户针对业务、服务或产品采取行动。 | 
AdPolicy
与广告组广告相关联的单个广告政策。
| JSON 表示法 | 
|---|
| { "adPolicyApprovalStatus": enum ( | 
| 字段 | |
|---|---|
| adPolicyApprovalStatus | 
 广告的政策审批状态,表示审批决定。 | 
| adPolicyReviewStatus | 
 广告的政策审核状态,指明广告目前处于审核流程的哪个阶段。 | 
| adPolicyTopicEntry[] | 
 与广告相关的每个政策主题的条目。每个条目都包含主题、限制级别以及有关如何解决政策问题的指导。 | 
AdPolicyApprovalStatus
广告政策审批的可能状态。
| 枚举 | |
|---|---|
| AD_POLICY_APPROVAL_STATUS_UNKNOWN | 未知或未指定。 | 
| DISAPPROVED | 不会投放。 | 
| APPROVED_LIMITED | 将投放,但有限制。 | 
| APPROVED | 将不受限制地投放。 | 
| AREA_OF_INTEREST_ONLY | 不会在定位到的国家/地区展示,但可能会向搜索定位到的国家/地区相关信息的用户展示。 | 
AdPolicyReviewStatus
广告政策审核的可能状态。
| 枚举 | |
|---|---|
| AD_POLICY_REVIEW_STATUS_UNKNOWN | 未知或未指定。 | 
| REVIEW_IN_PROGRESS | 目前正在审核中。 | 
| REVIEWED | 主要审核已完成。其他审核可能仍在进行中。 | 
| UNDER_APPEAL | 已重新提交以供审批,或已就违规判定提出申诉。 | 
| ELIGIBLE_MAY_SERVE | 被视为符合条件,可能正在投放。后续可能仍需进一步审核。 | 
AdPolicyTopicEntry
一个条目,用于说明广告是如何被确定为与广告政策相关的。
| JSON 表示法 | 
|---|
| { "policyTopic": string, "policyLabel": string, "policyTopicDescription": string, "policyTopicType": enum ( | 
| 字段 | |
|---|---|
| policyTopic | 
 政策主题。 例如“商标”“酒精”等。 | 
| policyLabel | 
 相应政策的本地化标签文本。 例如,“文字中的商标”“含有酒精”等。 | 
| policyTopicDescription | 
 政策主题的简短摘要说明。 | 
| policyTopicType | 
 广告投放因与广告政策主题相关而受到的影响。 | 
| policyDecisionType | 
 政策决定的来源。 | 
| policyEnforcementMeans | 
 政策审核中使用的政策执行方式。 | 
| policyTopicEvidences[] | 
 政策决定中使用的证据。 | 
| policyTopicConstraints[] | 
 与政策判定相关的投放限制。 | 
| helpCenterLink | 
 相应政策主题的广告政策帮助中心链接。 | 
| appealInfo | 
 有关如何就违规判定提出申诉的信息。 | 
AdPolicyTopicEntryType
广告政策主题可能对广告投放产生的影响。
| 枚举 | |
|---|---|
| AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN | 未知或未指定。 | 
| PROHIBITED | 相应资源将不会投放。 | 
| FULLY_LIMITED | 相应资源将无法在所有目标国家/地区投放。 | 
| LIMITED | 相应资源无法在某些国家/地区投放。 | 
| DESCRIPTIVE | 资源可以投放。 | 
| BROADENING | 资源可以投放,并且可能超出正常覆盖范围。 | 
| AREA_OF_INTEREST_ONLY | 该资源在所有目标国家/地区都受到限制,但可能会向搜索目标国家/地区相关信息的用户展示。 | 
AdPolicyDecisionType
政策判定的可能来源。
| 枚举 | |
|---|---|
| AD_POLICY_DECISION_TYPE_UNKNOWN | 未知或未指定。 | 
| PURSUANT_TO_NOTICE | 此决定是根据法律通知、法院命令或商标内容所有者的投诉等做出的。 | 
| GOOGLE_INVESTIGATION | 此决定是 Google 自行调查后做出的。 | 
AdPolicyEnforcementMeans
政策审核中可能使用的政策违规处置措施。
| 枚举 | |
|---|---|
| AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN | 未知或未指定。 | 
| AUTOMATED | 违规处置流程完全自动化。 | 
| HUMAN_REVIEW | 在违规处置流程中,有人工部分或完全参与。 | 
AdPolicyTopicEvidence
政策决策中使用的证据信息。
| JSON 表示法 | 
|---|
| { // Union field | 
| 字段 | |
|---|---|
| 联合字段 value。违规认定的证据。value只能是下列其中一项: | |
| textList | 
 广告文字中找到的证据列表。 | 
| websiteList | 
 与广告相关联的网站的列表。 | 
| httpCode | 
 抓取最终网址时返回的 HTTP 代码。 | 
| languageCode | 
 检测到的广告所用语言。 此字段使用 IETF 语言标记,例如“en-US”。 | 
| destinationTextList | 
 广告目标页面中导致违规的文字。 | 
| destinationMismatch | 
 广告目标网址不一致。 | 
| destinationNotWorking | 
 与广告着陆页相关的 HTTP 或 DNS 错误信息。 | 
| trademark | 
 导致违反政策的商标字词。 | 
| legalRemoval | 
 因法律相关法规强制执行而导致违反政策。 | 
| counterfeit | 
 导致违规的仿冒商品处置措施。 | 
| regionalRequirements | 
 导致违规的 T&S 主动执行操作。 | 
TextList
违反政策的文本片段列表。
| JSON 表示法 | 
|---|
| { "texts": [ string ] } | 
| 字段 | |
|---|---|
| texts[] | 
 导致政策发现的资源中的文本片段。 | 
WebsiteList
违反政策的网站列表。
| JSON 表示法 | 
|---|
| { "websites": [ string ] } | 
| 字段 | |
|---|---|
| websites[] | 
 导致政策结果的网站。 | 
DestinationTextList
违反政策的目标文字列表。
| JSON 表示法 | 
|---|
| { "destinationTexts": [ string ] } | 
| 字段 | |
|---|---|
| destinationTexts[] | 
 导致发现违规问题的目标文本。 | 
DestinationMismatch
有关目标网址类型不匹配的详细信息。
| JSON 表示法 | 
|---|
| {
  "uriTypes": [
    enum ( | 
| 字段 | |
|---|---|
| uriTypes[] | 
 不匹配的网址集。该列表可以包含单个或多个 URI 类型。 示例 1:[ 示例 2:[ | 
AdPolicyTopicEvidenceDestinationMismatchUrlType
可能的网址类型。
| 枚举 | |
|---|---|
| AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN | 未指定或未知。 | 
| DISPLAY_URL | 显示网址。 | 
| FINAL_URL | 最终到达网址。 | 
| FINAL_MOBILE_URL | 最终到达移动网址。 | 
| TRACKING_URL | 跟踪网址。 | 
| MOBILE_TRACKING_URL | 移动跟踪网址。 | 
DestinationNotWorking
与广告着陆页相关的 HTTP 或 DNS 错误的详细信息。
| JSON 表示法 | 
|---|
| { "expandedUri": string, "device": enum ( | 
| 字段 | |
|---|---|
| expandedUri | 
 无法正常运行的完整网址。 | 
| device | 
 访问相应网址时出现错误的设备。 | 
| lastCheckedTime | 
 导航到相应网址时上次看到该错误的时间。 采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: | 
| 联合字段 reason。HTTP 或 DNS 错误。reason只能是下列其中一项: | |
| dnsErrorType | 
 DNS 错误的类型。 | 
| httpErrorCode | 
 HTTP 错误代码。 | 
AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
可能的 DNS 错误类型。
| 枚举 | |
|---|---|
| AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN | 未指定或未知。 | 
| HOSTNAME_NOT_FOUND | 在提取着陆页时,DNS 中未找到主机名。 | 
| GOOGLE_CRAWLER_DNS_ISSUE | 在与 DNS 通信时,Google 无法抓取着陆页。 | 
AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
访问相应网址时可能出现错误的设备。
| 枚举 | |
|---|---|
| AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN | 未指定或未知。 | 
| DESKTOP | 桌面设备。 | 
| ANDROID | Android 设备。 | 
| IOS | iOS 设备。 | 
商标
导致违反政策的商标字词。
| JSON 表示法 | 
|---|
| {
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object ( | 
| 字段 | |
|---|---|
| owner | 
 商标内容所有者。 | 
| term | 
 商标用语。 | 
| countryRestrictions[] | 
 政策违规行为的相关国家/地区。 | 
AdPolicyCriterionRestriction
表示国家/地区限制。
| JSON 表示法 | 
|---|
| { "countryCriterionId": string, "countryLabel": string } | 
| 字段 | |
|---|---|
| countryCriterionId | 
 国家/地区条件 ID。 | 
| countryLabel | 
 相应国家/地区的本地化名称。可以为空。 | 
LegalRemoval
与法律相关的法规强制执行,无论是根据 DMCA 还是当地法律法规。
| JSON 表示法 | 
|---|
| { "complaintType": enum ( | 
| 字段 | |
|---|---|
| complaintType | 
 导致法律移除的投诉类型。 | 
| countryRestrictions[] | 
 因法律移除而受到限制的国家/地区。 | 
| restrictedUris[] | 
 因法律移除要求而受到限制的网址。 | 
| 联合字段 type。有关法律移除类型的详细信息。type只能是下列其中一项: | |
| dmca | 
 有关 DMCA 法规依法移除的详细信息。 | 
| localLegal | 
 有关本地法律法规规定的合法移除的详细信息。 | 
数字千年版权法案 (DMCA)
DMCA 投诉详情。
| JSON 表示法 | 
|---|
| { "complainant": string } | 
| 字段 | |
|---|---|
| complainant | 
 提交法律投诉的实体。 | 
LocalLegal
当地法律法规的详细信息。
| JSON 表示法 | 
|---|
| { "lawType": string } | 
| 字段 | |
|---|---|
| lawType | 
 法律声明所依据的法律类型。 | 
AdPolicyTopicEvidenceLegalRemovalComplaintType
依法移除可能涉及的投诉类型。
| 枚举 | |
|---|---|
| AD_POLICY_TOPIC_EVIDENCE_LEGAL_REMOVAL_COMPLAINT_TYPE_UNKNOWN | 未指定或未知。 | 
| COPYRIGHT | 版权。 仅适用于 DMCA。 | 
| COURT_ORDER | 法院命令。 仅适用于当地法律。 | 
| LOCAL_LEGAL | 当地法律法规。 仅适用于当地法律。 | 
仿冒
导致政策违规的仿冒商品处置措施的详细信息。
| JSON 表示法 | 
|---|
| { "owners": [ string ] } | 
| 字段 | |
|---|---|
| owners[] | 
 提出投诉的内容或商品所有者。 | 
RegionalRequirements
针对旨在满足区域要求的政策,信任与安全 (T&S) 团队会主动执行违规处置措施。由于这是主动执行服务条款及政策,因此被视为 Google 自行开展的调查,而不是违规处置通知。
| JSON 表示法 | 
|---|
| {
  "regionalRequirementsEntries": [
    {
      object ( | 
| 字段 | |
|---|---|
| regionalRequirementsEntries[] | 
 地区要求列表。 | 
RegionalRequirementsEntry
政策级区域法律违规详情。
| JSON 表示法 | 
|---|
| {
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object ( | 
| 字段 | |
|---|---|
| legalPolicy | 
 所违反的法律政策。 | 
| countryRestrictions[] | 
 因法律政策而受到限制的国家/地区。 | 
AdPolicyTopicConstraint
广告投放限制的详细信息。
| JSON 表示法 | 
|---|
| { "requestCertificateFormLink": string, // Union field | 
| 字段 | |
|---|---|
| requestCertificateFormLink | 
 指向用于请求约束证书的表单的链接。 | 
| 联合字段 constraint。投放限制。constraint只能是下列其中一项: | |
| countryConstraint | 
 无法投放广告的国家/地区。 | 
| resellerConstraint | 
 转销商限制。 | 
| certificateMissingCountryList | 
 需要证书才能投放广告的国家/地区。 | 
| certificateDomainMismatchCountryList | 
 资源网域未被与其关联的证书覆盖的国家/地区。 | 
| globalCertificateMissing | 
 必须要有证书,才能在任何国家/地区投放。 | 
| globalCertificateDomainMismatch | 
 必须提供证书才能在任何国家/地区投放广告,但现有证书未涵盖相应广告的网域。 | 
AdPolicyCountryConstraintList
由于政策限制,广告无法投放到的国家/地区列表。
| JSON 表示法 | 
|---|
| {
  "countries": [
    {
      object ( | 
| 字段 | |
|---|---|
| countries[] | 
 无法投放广告的国家/地区。 | 
AdPolicyResellerConstraint
此类型没有字段。
由于网站被拒批(用于经销商目的),政策主题受到限制。
AdPolicyGlobalCertificateMissingConstraint
此类型没有字段。
必须要有证书,才能在任何国家/地区投放。
AdPolicyGlobalCertificateDomainMismatchConstraint
此类型没有字段。
必须提供证书才能在任何国家/地区投放广告,但现有证书未涵盖相应广告的网域。
AdPolicyTopicAppealInfo
有关如何就违规认定提出申诉的信息。
| JSON 表示法 | 
|---|
| {
  "appealType": enum ( | 
| 字段 | |
|---|---|
| appealType | 
 相应判定是否可以通过自助申诉或申诉表单进行申诉。 | 
| appealFormLink | 
 仅当  | 
AdPolicyAppealType
可能的申诉类型。
| 枚举 | |
|---|---|
| AD_POLICY_APPEAL_TYPE_UNKNOWN | 未知或未指定。 | 
| SELF_SERVICE_APPEAL | 您可以通过自助申诉流程对该决定提出申诉。 | 
| APPEAL_FORM | 您可以使用申诉表单对此决定提出申诉。 | 
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 | 一个 1x1 跟踪像素,用于在投放广告素材的展示时发送 ping。 | 
| AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION | 可扩展的 DCM 展示信标。在投放时,它会扩展为多个信标。 | 
| AD_URL_TYPE_BEACON_CLICK | 点击事件触发时要 ping 的跟踪网址。 | 
| AD_URL_TYPE_BEACON_SKIP | 在触发跳过事件时要 ping 的跟踪网址。 | 
| 方法 | |
|---|---|
| 
 | 获取广告组广告。 | 
| 
 | 列出广告组广告。 |