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