- 资源: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 的跟踪网址。 | 
方法 | 
            |
|---|---|
                
 | 
              获取广告组广告。 | 
                
 | 
              列出广告组广告。 |