REST Resource: advertisers.adGroupAds

资源:AdGroupAd

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
字段
name

string

仅限输出。广告的资源名称。

advertiserId

string (int64 format)

仅限输出。广告所属广告客户的唯一 ID。

adGroupAdId

string (int64 format)

仅限输出。广告的唯一 ID。由系统分配。

adGroupId

string (int64 format)

必需。不可变。广告所属广告组的唯一 ID。

displayName

string

必需。广告的显示名称。

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

adPolicy

object (AdPolicy)

仅限输出。广告的政策审批状态。

entityStatus

enum (EntityStatus)

必需。广告的实体状态。

adUrls[]

object (AdUrl)

仅限输出。广告使用的网址列表。

dcmTrackingInfo

object (DcmTrackingInfo)

可选。DCM 跟踪广告信息。仅对需求开发广告有效。

如需移除 DCM 跟踪广告信息,请将此字段留空。

广告的详细信息。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
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)

仅限输出。行动号召视频广告系列中所用广告的详细信息,该广告系列旨在吸引用户针对业务、服务或产品采取行动。

demandGenVideoAd

object (DemandGenVideoAd)

需求开发视频广告的详细信息。

demandGenImageAd

object (DemandGenImageAd)

需求开发图片广告的详细信息。

demandGenProductAd

object (DemandGenProductAd)

需求开发产品广告的详细信息。

互斥字段结束。

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)

在桌面设备上的标头广告旁边显示的视频。最多只能有两个。

YoutubeVideoDetails

YouTube 视频的详细信息。

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

string

仅限输出。可在 YouTube 网页上搜索的 YouTube 视频 ID。

unavailableReason

enum (VideoUnavailableReason)

视频数据不可用的原因。

videoAssetId

string (int64 format)

必需。YouTube 视频素材资源 ID。这是 AdAsset 资源的 adAssetId。

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,
  "assetId": string
}
字段
mimeType

string

仅限输出。图片素材资源的 MIME 类型。

fullSize

object (Dimensions)

仅限输出。此图片原始尺寸的元数据。

fileSize

string (int64 format)

仅限输出。图片素材资源的文件大小(以字节为单位)。

assetId

string (int64 format)

必需。素材资源的唯一 ID。

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)
    }
  ],
  "businessName": string,
  "logo": {
    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)

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

businessName

string

可选。广告中显示的商家名称。

除非在广告客户一级设置了默认值,否则必须指定此设置。如果未设置,系统将应用默认值。

DemandGenVideoAd

需求开发视频广告的详细信息。

JSON 表示法
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
字段
finalUrl

string

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

trackingUrl

string

仅限输出。在后台加载的用于跟踪目的的网址。

userSpecifiedTrackingUrl

string

可选。用户手动指定的跟踪网址。

callToAction

enum (CallToAction)

必需。广告上显示的行动号召按钮。

支持的值如下:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

必需。广告中显示的标题列表。

longHeadlines[]

string

必需。广告中显示的长标题列表。

descriptions[]

string

必需。广告中显示的广告内容描述列表。

displayUrlBreadcrumb1

string

可选。显示网址中域名后面的第一部分。

displayUrlBreadcrumb2

string

可选。显示网址中域名后面的第二部分。

videos[]

object (YoutubeVideoDetails)

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

customParameters

map (key: string, value: string)

可选。要添加到跟踪网址的自定义参数和随附值。

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

companionBanner

object (ImageAsset)

可选。此广告使用的随播横幅广告。

finalMobileUrl

string

可选。用户在移动设备上点击广告后到达的网页的网址。

finalUrlSuffix

string

可选。要附加到着陆页网址的后缀。

businessName

string

可选。广告中显示的商家名称。

除非在广告客户一级设置了默认值,否则必须指定此设置。如果未设置,系统将应用默认值。

CallToAction

需求开发产品/视频广告的可能号召性用语值。

枚举
CALL_TO_ACTION_UNSPECIFIED 未指定或未知。
AUTOMATED 由系统自动拨打。
LEARN_MORE 了解详情。
GET_QUOTE 获取报价。
APPLY_NOW 立即申请。
SIGN_UP 注册。
CONTACT_US 与我们联系。
SUBSCRIBE 订阅。
DOWNLOAD 下载。
BOOK_NOW 立即预订。
SHOP_NOW 立即选购。
BUY_NOW 立即购买。
DONATE_NOW 立即捐款。
ORDER_NOW 立即订购。
PLAY_NOW 立即畅玩。
SEE_MORE 查看详情。
START_NOW 立即启动。
VISIT_SITE 访问网站。
WATCH_NOW 立即观看。

DemandGenImageAd

需求开发图片广告的详细信息。

JSON 表示法
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
字段
finalUrl

string

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

trackingUrl

string

仅限输出。在后台加载的用于跟踪目的的网址。

userSpecifiedTrackingUrl

string

可选。用户手动指定的跟踪网址。

callToAction

string

必需。广告上显示的行动号召按钮。

headlines[]

string

必需。广告中显示的标题列表。

descriptions[]

string

必需。广告中显示的广告内容描述列表。

customParameters

map (key: string, value: string)

可选。要添加到跟踪网址的自定义参数和随附值。

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

finalMobileUrl

string

可选。用户在移动设备上点击广告后到达的网页的网址。

finalUrlSuffix

string

可选。要附加到着陆页网址的后缀。

businessName

string

可选。广告中显示的商家名称。

除非在广告客户一级设置了默认值,否则必须指定此设置。如果未设置,系统将应用默认值。

marketingImages[]

object (ImageAsset)

广告中显示的营销图片列表。

squareMarketingImages[]

object (ImageAsset)

广告中显示的方形营销图片列表。

portraitMarketingImages[]

object (ImageAsset)

广告中显示的纵向营销图片列表。

logoImages[]

object (ImageAsset)

广告中显示的徽标图片列表。

除非在广告客户一级设置了默认值,否则必须指定此设置。如果未设置,系统将应用默认值。

DemandGenCarouselAd

需求开发轮播广告的详细信息。

JSON 表示法
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
字段
finalUrl

string

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

headline

string

必需。广告的标题。

description

string

必需。广告的说明。

cards[]

object (CarouselCard)

必需。广告中显示的卡片列表。

finalUrlSuffix

string

可选。要附加到着陆页网址的后缀。

trackingUrl

string

仅限输出。在后台加载的用于跟踪目的的网址。

userSpecifiedTrackingUrl

string

可选。用户手动指定的跟踪网址。

businessName

string

可选。广告中显示的商家名称。

除非在广告客户一级设置了默认值,否则必须指定此设置。如果未设置,系统将应用默认值。

customParameters

map (key: string, value: string)

可选。要添加到跟踪网址的自定义参数和随附值。

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

CarouselCard

需求开发广告轮播卡片的详细信息。

JSON 表示法
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
字段
finalUrl

string

必需。用户点击卡片后到达的网页的网址。

finalMobileUrl

string

可选。用户在移动设备上点击卡片后到达的网页的网址。

headline

string

必需。卡片的标题。

callToAction

string

必需。卡片上显示的行动号召按钮中的文字。

不得超过 10 个字符。

marketingImage

object (ImageAsset)

可选。卡片上显示的营销图片。

squareMarketingImage

object (ImageAsset)

可选。卡片上显示的方形营销图片。

portraitMarketingImage

object (ImageAsset)

可选。卡片上显示的纵向营销图片。

DemandGenProductAd

需求开发产品广告的详细信息。

JSON 表示法
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
字段
finalUrl

string

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

headline

string

必需。广告的标题。

description

string

必需。广告的说明。

finalUrlSuffix

string

可选。要附加到着陆页网址的后缀。

callToAction

enum (CallToAction)

必需。广告上显示的行动号召按钮。

支持的值如下:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

仅限输出。在后台加载的用于跟踪目的的网址。

userSpecifiedTrackingUrl

string

可选。用户手动指定的跟踪网址。

businessName

string

可选。广告中显示的商家名称。

除非在广告客户一级设置了默认值,否则必须指定此设置。如果未设置,系统将应用默认值。

customParameters

map (key: string, value: string)

可选。要添加到跟踪网址的自定义参数和随附值。

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

displayUrlBreadcrumb1

string

可选。显示网址中域名后面的第一部分。

displayUrlBreadcrumb2

string

可选。显示网址中域名后面的第二部分。

AdPolicy

与广告组广告关联的单个广告政策。

JSON 表示法
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
字段
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

广告的政策审批状态,表示审批决定。

adPolicyReviewStatus

enum (AdPolicyReviewStatus)

广告的政策审核状态,表示广告当前处于审核流程中的哪个阶段。

adPolicyTopicEntry[]

object (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 (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
字段
policyTopic

string

政策主题。

例如“TRADEMARKS”“ALCOHOL”等。

policyLabel

string

政策的本地化标签文本。

例如“文字中包含商标”“包含酒精饮料”等。

policyTopicDescription

string

对政策主题的简短摘要说明。

policyTopicType

enum (AdPolicyTopicEntryType)

广告投放将如何受到广告政策主题的影响。

policyDecisionType

enum (AdPolicyDecisionType)

违规认定的来源。

policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

政策审核中使用的违规处置方式。

policyTopicEvidences[]

object (AdPolicyTopicEvidence)

违规认定中使用的证据。

policyTopicConstraints[]

object (AdPolicyTopicConstraint)

与违规认定相关的投放限制。

appealInfo

object (AdPolicyTopicAppealInfo)

有关如何就违规认定提出申诉的信息。

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 表示法
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
字段
违规认定的证据。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
textList

object (TextList)

在广告文字中找到的证据列表。

websiteList

object (WebsiteList)

与广告关联的网站列表。

httpCode

integer

抓取最终到达网址时返回的 HTTP 代码。

languageCode

string

检测到的广告所用语言。

此字段使用 IETF 语言代码,例如“en-US”。

destinationTextList

object (DestinationTextList)

广告目标页面中导致违规的文字。

destinationMismatch

object (DestinationMismatch)

广告目标网址不一致。

destinationNotWorking

object (DestinationNotWorking)

与广告目标页面相关的 HTTP 或 DNS 错误信息。

trademark

object (Trademark)

导致违规的商标用语。

legalRemoval

object (LegalRemoval)

因法律相关法规执行而导致的违规。

counterfeit

object (Counterfeit)

因违反仿冒政策而采取的违规处置措施。

regionalRequirements

object (RegionalRequirements)

T&S 主动违规处置导致了违规。

互斥字段结束。

TextList

违反政策的文本片段列表。

JSON 表示法
{
  "texts": [
    string
  ]
}
字段
texts[]

string

资源中导致政策发现结果的文本片段。

WebsiteList

违反政策的网站列表。

JSON 表示法
{
  "websites": [
    string
  ]
}
字段
websites[]

string

导致政策违规问题的网站。

DestinationTextList

违反政策的目标文字列表。

JSON 表示法
{
  "destinationTexts": [
    string
  ]
}
字段
destinationTexts[]

string

导致政策发现结果的目标文本。

DestinationMismatch

目标网址类型不匹配的详细信息。

JSON 表示法
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
字段
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

不匹配的网址集。该列表可以包含单个或多个 URI 类型。

示例 1:[DISPLAY_URL, FINAL_URL] 表示广告显示网址与广告最终到达网址不一致。

示例 2:[FINAL_URL] 表示广告最终到达网址与抓取的网址不一致,这也属于目标页面不匹配。

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 (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
字段
expandedUri

string

无法正常访问的完整网址。

device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

访问网址时导致错误的设备。

lastCheckedTime

string (Timestamp format)

上次在导航到网址时发现错误的时间。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

HTTP 或 DNS 错误。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

DNS 错误的类型。

httpErrorCode

string (int64 format)

HTTP 错误代码。

互斥字段结束。

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

可能的 DNS 错误类型。

枚举
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN 未指定或未知。
HOSTNAME_NOT_FOUND 提取着陆页时,在 DNS 中找不到主机名。
GOOGLE_CRAWLER_DNS_ISSUE Google 在与 DNS 通信时无法抓取着陆页。

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

访问该网址时可能出现错误的设备。

枚举
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN 未指定或未知。
DESKTOP 桌面设备。
ANDROID Android 设备。
IOS iOS 设备。

商标

导致违规的商标用语。

JSON 表示法
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
字段
owner

string

商标内容所有者。

term

string

商标用语。

countryRestrictions[]

object (AdPolicyCriterionRestriction)

违规行为涉及的国家/地区。

AdPolicyCriterionRestriction

表示国家/地区限制。

JSON 表示法
{
  "countryCriterionId": string,
  "countryLabel": string
}
字段
countryCriterionId

string (int64 format)

国家/地区条件 ID。

countryLabel

string

国家/地区的本地化名称。可能为空。

LegalRemoval

法律相关法规执行,无论是来自 DMCA 还是当地法律法规。

JSON 表示法
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
字段
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

导致依法移除的投诉类型。

countryRestrictions[]

object (AdPolicyCriterionRestriction)

因依法移除而受到限制的国家/地区。

restrictedUris[]

string

因依法移除而受到限制的网址。

依法移除类型的详细信息。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
dmca

object (Dmca)

有关 DMCA 法规依法移除的详细信息。

互斥字段结束。

数字千年版权法案 (DMCA)

DMCA 投诉详情。

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

string

提出法律投诉的实体。

LocalLegal

当地法律法规详情。

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

string

法律声明所依据的法律类型。

AdPolicyTopicEvidenceLegalRemovalComplaintType

依法移除的可能投诉类型。

枚举
COPYRIGHT

版权。

仅适用于 DMCA。

COURT_ORDER

法院命令。

仅适用于当地法律。

仿冒

导致违规的仿冒品违规处置措施的详细信息。

JSON 表示法
{
  "owners": [
    string
  ]
}
字段
owners[]

string

提出投诉的内容或产品所有者。

RegionalRequirements

信任与安全 (T&S) 团队主动执行旨在满足地区要求的政策。这属于 Google 主导的调查,而非监管通知,因为这是 T&S 团队主动采取的违规处置措施。

JSON 表示法
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
字段
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

地区要求列表。

RegionalRequirementsEntry

政策级地区性法律违规详情。

JSON 表示法
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
字段
legalPolicy

string

违反的法律政策。

countryRestrictions[]

object (AdPolicyCriterionRestriction)

因法律政策而受到限制的国家/地区。

AdPolicyTopicConstraint

有关广告投放限制的详细信息。

JSON 表示法
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
字段
投放限制。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
countryConstraint

object (AdPolicyCountryConstraintList)

广告无法投放的国家/地区。

resellerConstraint

object (AdPolicyResellerConstraint)

转销商限制。

certificateMissingCountryList

object (AdPolicyCountryConstraintList)

需要证书才能投放广告的国家/地区。

certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

资源的网域未被与其关联的证书覆盖的国家/地区。

globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

必须要有证书,才能在任何国家/地区投放。

globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

必须提供证书才能在任何国家/地区投放广告,而现有证书未涵盖广告的网域。

互斥字段结束。

AdPolicyCountryConstraintList

因政策限制而无法投放广告的国家/地区列表。

JSON 表示法
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
字段
countries[]

object (AdPolicyCriterionRestriction)

广告无法投放的国家/地区。

AdPolicyResellerConstraint

此类型没有字段。

由于网站因转销商用途而被拒登,政策主题受到限制。

AdPolicyGlobalCertificateMissingConstraint

此类型没有字段。

必须要有证书,才能在任何国家/地区投放。

AdPolicyGlobalCertificateDomainMismatchConstraint

此类型没有字段。

必须提供证书才能在任何国家/地区投放广告,而现有证书未涵盖广告的网域。

AdPolicyTopicAppealInfo

有关如何就违规认定提出申诉的信息。

JSON 表示法
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
字段
appealType

enum (AdPolicyAppealType)

是否可以通过自助申诉或申诉表单对该判定提出申诉。

AdPolicyAppealType

可能的申诉类型。

枚举
AD_POLICY_APPEAL_TYPE_UNKNOWN 未知或未指定。
SELF_SERVICE_APPEAL 您可以通过自助申诉对该判定提出申诉。
APPEAL_FORM 您可以使用申诉表单对该决定提出申诉。

AdUrl

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

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

enum (AdUrlType)

广告网址的类型。

url

string

网址字符串值。

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

DcmTrackingInfo

DCM 跟踪的详细信息。

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

string (int64 format)

必需。DCM 展示位置 ID。

trackingAdId

string (int64 format)

必需。DCM 跟踪广告 ID。

creativeId

string (int64 format)

必需。DCM 广告素材 ID。

方法

create

创建广告组广告。

delete

删除广告组广告。

get

获取广告组广告。

list

列出广告组广告。

patch

更新广告组广告。