- 资源:广告
- FinalAppUrl
- AppUrlOperatingSystemType
- CustomParameter
- AdType
- 设备
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- CallConversionReportingState
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- MimeType
- AdImageAsset
- VideoAdInfoVideoAdInfo
- AdVideoAsset
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- AdTextAsset
- ServedAssetFieldType
- AssetPerformanceLabel
- AdAssetPolicySummary
- PolicyTopicEntry
- PolicyTopicEntryType
- PolicyTopicEvidence
- WebsiteList
- TextList
- DestinationTextList
- DestinationMismatch
- PolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- PolicyTopicEvidenceDestinationNotWorkingDevice
- PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- PolicyTopicConstraint
- CountryConstraintListCountryConstraintList
- CountryConstraintCountryConstraint
- ResellerConstraint
- PolicyReviewStatus
- PolicyApprovalStatus
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- SmartCampaignAdInfo
- AppPreRegistrationAdInfo
- DiscoveryMultiAssetAdInfo
- DiscoveryCarouselAdInfo
- AdDiscoveryCarouselCardAsset
- DiscoveryVideoResponsiveAdInfo
- AdCallToActionAsset
- TravelAdInfo
- 方法
资源:Ad
某个广告。
JSON 表示法 |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
字段 | |
---|---|
resourceName |
不可变。广告的资源名称。广告资源名称采用以下形式:
|
finalUrls[] |
广告的所有跨网域重定向之后可能存在的最终到达网址列表。 |
finalAppUrls[] |
用户安装了特定应用后在移动设备上使用的最终到达应用网址列表。 |
finalMobileUrls[] |
广告的所有跨网域重定向之后可能存在的最终到达移动网址列表。 |
urlCustomParameters[] |
可用于替换 |
type |
仅供输出。广告的类型。 |
devicePreference |
广告的设备偏好设置。您只能指定移动设备的偏好设置。设置此偏好设置后,当某广告在移动设备上展示时,该广告将优于其他广告。广告仍可在其他类型的设备上展示,例如在没有其他广告可投放时。如果未指定(无设备偏好设置),则系统会定位所有设备。仅受部分广告类型支持。 |
urlCollections[] |
广告的其他网址,该网址带有可从广告中的其他字段引用的唯一标识符。 |
systemManagedResourceSource |
仅供输出。如果广告由系统管理,则此字段会指示来源。此字段为只读字段。 |
id |
仅供输出。广告的 ID。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。 |
finalUrlSuffix |
构建最终到达网址时要使用的后缀。 |
displayUrl |
在某些广告格式的广告说明中显示的网址。 |
addedByGoogleAds |
仅供输出。指示此广告是否由 Google Ads 自动添加,而不是由用户添加。例如,当根据现有广告的效果自动创建广告作为新广告的建议时,可能会发生这种情况。 |
name |
不可变。广告的名称。这仅用于识别广告。该名称不必是唯一的,也不会影响投放的广告。目前,只有 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd 支持 name 字段。 |
联合字段 ad_data 。与广告类型相关的详情。必须且只能设置一个值。ad_data 只能是下列其中一项: |
|
textAd |
不可变。与文字广告有关的详细信息。 |
expandedTextAd |
与加大型文字广告有关的详细信息。 |
callAd |
与来电广告相关的详细信息。 |
expandedDynamicSearchAd |
不可变。与加大型动态搜索广告有关的详细信息。此类广告会根据在广告系列一级链接的 |
hotelAd |
与酒店广告相关的详细信息。 |
shoppingSmartAd |
与智能购物广告的有关详细信息。 |
shoppingProductAd |
与产品购物广告的有关详细信息。 |
imageAd |
不可变。与图片广告有关的详细信息。 |
videoAd |
与视频广告相关的详细信息。 |
videoResponsiveAd |
与视频自适应广告有关的详细信息。 |
responsiveSearchAd |
与自适应搜索广告有关的详细信息。 |
legacyResponsiveDisplayAd |
与旧版自适应展示广告有关的详细信息。 |
appAd |
与应用广告相关的详细信息。 |
legacyAppInstallAd |
不可变。与旧版应用安装广告相关的详细信息。 |
responsiveDisplayAd |
与自适应展示广告有关的详细信息。 |
localAd |
与本地广告相关的详细信息。 |
displayUploadAd |
与上传的展示广告相关的详细信息。 |
appEngagementAd |
与应用互动广告相关的详细信息。 |
shoppingComparisonListingAd |
与购物比较购物广告相关的详细信息。 |
smartCampaignAd |
与智能广告系列中的广告相关的详细信息。 |
appPreRegistrationAd |
与应用预注册广告相关的详情。 |
discoveryMultiAssetAd |
与多重素材资源发现广告有关的详细信息。 |
discoveryCarouselAd |
与轮播式发现广告的相关详情。 |
discoveryVideoResponsiveAd |
与视频发现广告的自适应广告相关的详细信息。 |
travelAd |
与旅游广告相关的详情。 |
FinalAppUrl
用于深层链接到给定操作系统应用中的应用的网址。
JSON 表示法 |
---|
{
"osType": enum ( |
字段 | |
---|---|
osType |
此网址定位的操作系统。必填。 |
url |
应用深层链接网址。深层链接用于指定应用中与您要显示的内容相对应的位置,其格式应为 {scheme}://{host_path}。该 scheme 方案用于标识要打开哪个应用。对于您的应用,您可以使用以应用名称开头的自定义架构。主机和路径指定您的内容在应用中的唯一位置。例如:“exampleapp://productid_1234”。必填。 |
AppUrlOperatingSystemType
操作系统
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
IOS |
Apple IOS 操作系统。 |
ANDROID |
Android 操作系统。 |
CustomParameter
可供 trackingUrlTemplate
、finalUrls
或 mobile_final_urls
中的自定义参数代码使用的映射。
JSON 表示法 |
---|
{ "key": string, "value": string } |
字段 | |
---|---|
key |
与参数标记名称匹配的键。 |
value |
要替换的值。 |
AdType
广告的可能类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知接收的值。 这是一个仅用于响应的值。 |
TEXT_AD |
该广告是文字广告。 |
EXPANDED_TEXT_AD |
该广告是加大型文字广告。 |
EXPANDED_DYNAMIC_SEARCH_AD |
该广告是加大型动态搜索广告。 |
HOTEL_AD |
该广告是酒店广告。 |
SHOPPING_SMART_AD |
该广告是智能购物广告。 |
SHOPPING_PRODUCT_AD |
该广告是标准购物广告。 |
VIDEO_AD |
该广告是一个视频广告。 |
IMAGE_AD |
此广告是图片广告。 |
RESPONSIVE_SEARCH_AD |
该广告是自适应搜索广告。 |
LEGACY_RESPONSIVE_DISPLAY_AD |
该广告是旧版自适应展示广告。 |
APP_AD |
该广告是应用广告。 |
LEGACY_APP_INSTALL_AD |
该广告是旧版应用安装广告。 |
RESPONSIVE_DISPLAY_AD |
该广告是自适应展示广告。 |
LOCAL_AD |
该广告是本地广告。 |
HTML5_UPLOAD_AD |
该广告是产品类型为“HTML5_UPLOAD_AD”的展示广告上传广告。 |
DYNAMIC_HTML5_AD |
该广告是上传展示广告,其中包含一种 DYNAMIC_HTML5_* 产品类型。 |
APP_ENGAGEMENT_AD |
该广告是应用互动广告。 |
SHOPPING_COMPARISON_LISTING_AD |
该广告是比价购物广告。 |
VIDEO_BUMPER_AD |
导视视频广告。 |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
不可跳过的插播广告。 |
VIDEO_OUTSTREAM_AD |
外播视频广告。 |
VIDEO_TRUEVIEW_IN_STREAM_AD |
TrueView 插播视频广告。 |
VIDEO_RESPONSIVE_AD |
视频自适应广告。 |
SMART_CAMPAIGN_AD |
智能广告系列。 |
CALL_AD |
来电广告。 |
APP_PRE_REGISTRATION_AD |
通用应用预注册广告。 |
IN_FEED_VIDEO_AD |
信息流视频广告。 |
DISCOVERY_MULTI_ASSET_AD |
多重素材资源发现广告。 |
DISCOVERY_CAROUSEL_AD |
轮播式发现广告。 |
TRAVEL_AD |
旅游广告。 |
DISCOVERY_VIDEO_RESPONSIVE_AD |
视频发现广告。 |
设备
枚举可用于定位的 Google Ads 设备。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
在此版本中,此值未知。 |
MOBILE |
配备完善的网络浏览功能的移动设备。 |
TABLET |
配备完善的网络浏览功能的平板电脑。 |
DESKTOP |
计算机。 |
CONNECTED_TV |
智能电视和游戏机。 |
OTHER |
其他设备类型。 |
UrlCollection
使用唯一标识符标记的网址集合。
JSON 表示法 |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
字段 | |
---|---|
finalUrls[] |
可能的最终到达网址列表。 |
finalMobileUrls[] |
可能的最终到达移动网址的列表。 |
urlCollectionId |
此 UrlCollection 实例的唯一标识符。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。 |
SystemManagedResourceSource
列出可能的系统管理的实体来源的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
AD_VARIATIONS |
生成的广告变体实验广告。 |
TextAdInfo
文字广告。
JSON 表示法 |
---|
{ "headline": string, "description1": string, "description2": string } |
字段 | |
---|---|
headline |
广告的标题。 |
description1 |
广告内容描述的第一行。 |
description2 |
广告内容描述的第二行。 |
ExpandedTextAdInfo
加大型文字广告。
JSON 表示法 |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
字段 | |
---|---|
headlinePart1 |
广告标题的第一部分。 |
headlinePart2 |
广告标题的第二部分。 |
headlinePart3 |
广告标题的第三部分。 |
description |
广告的广告内容描述。 |
description2 |
广告的第二条说明。 |
path1 |
可以与广告的显示网址一起显示的文字。 |
path2 |
可以与广告的显示网址一起显示的其他文字。 |
CallAdInfo
来电广告。
JSON 表示法 |
---|
{
"countryCode": string,
"phoneNumber": string,
"businessName": string,
"headline1": string,
"headline2": string,
"description1": string,
"description2": string,
"callTracked": boolean,
"disableCallConversion": boolean,
"phoneNumberVerificationUrl": string,
"conversionAction": string,
"conversionReportingState": enum ( |
字段 | |
---|---|
countryCode |
广告中的国家/地区代码。 |
phoneNumber |
广告中的电话号码。 |
businessName |
广告中的商家名称。 |
headline1 |
广告中的第一个标题。 |
headline2 |
广告中的第二个标题。 |
description1 |
广告内容描述的第一行。 |
description2 |
广告内容描述的第二行。 |
callTracked |
是否为广告素材启用来电跟踪。启用来电跟踪也会启用来电转化。 |
disableCallConversion |
是否为广告素材停用来电转化。如果设置为 |
phoneNumberVerificationUrl |
用于验证电话号码的网址。 |
conversionAction |
来电转化要归因于的转化操作。如果未设置,系统会使用默认转化操作。此字段仅在 |
conversionReportingState |
此来电广告的来电转化行为。它可以使用自己的来电转化设置、沿用帐号级设置,也可以被停用。 |
path1 |
可以附加到广告中网址的第一部分。可选。 |
path2 |
可以附加到广告中网址的第二部分文字。只有在同时设置了 |
CallConversionReportingState
来电转化操作状态的可能数据类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
DISABLED |
来电转化操作已停用。 |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
来电转化操作将使用在帐号一级设置的来电转化类型。 |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
来电转化操作将使用在资源(来电专用广告/附加电话信息)一级设置的来电转化类型。 |
ExpandedDynamicSearchAdInfo
加大型动态搜索广告。
JSON 表示法 |
---|
{ "description": string, "description2": string } |
字段 | |
---|---|
description |
广告的广告内容描述。 |
description2 |
广告的第二条说明。 |
HotelAdInfo
此类型没有任何字段。
酒店广告。
ShoppingSmartAdInfo
此类型没有任何字段。
智能购物广告。
ShoppingProductAdInfo
此类型没有任何字段。
标准购物广告。
ImageAdInfo
图片广告。
JSON 表示法 |
---|
{ "mimeType": enum ( |
字段 | |
---|---|
mimeType |
图片的 MIME 类型。 |
pixelWidth |
全尺寸图片的宽度(以像素为单位)。 |
pixelHeight |
全尺寸图片的高度(以像素为单位)。 |
imageUrl |
全尺寸图片的网址。 |
previewPixelWidth |
预览大小图片的宽度(以像素为单位)。 |
previewPixelHeight |
预览大小图片的高度(以像素为单位)。 |
previewImageUrl |
预览尺寸图片的网址。 |
name |
图片的名称。如果图片是从媒体文件创建的,这就是该媒体文件的名称。如果图片是通过字节创建的,则为空。 |
联合字段 image 。用于创建 ImageAd 的图片。可以通过以下两种方式之一来指定此类型。1. 现有的媒体文件资源。2. 以字节表示的原始图片数据。image 只能是下列其中一项: |
|
imageAsset |
广告所用的图片素材资源。 |
data |
原始图片数据(以字节形式)。 使用 base64 编码的字符串。 |
adIdToCopyImageFrom |
要从中复制图片的广告 ID。 |
MimeType
MIME 类型
枚举 | |
---|---|
UNSPECIFIED |
未指定 MIME 类型。 |
UNKNOWN |
此版本中未知接收的值。 这是一个仅用于响应的值。 |
IMAGE_JPEG |
image/jpeg MIME 类型。 |
IMAGE_GIF |
image/gif MIME 类型。 |
IMAGE_PNG |
image/png MIME 类型。 |
FLASH |
application/x-shockwave-flash MIME 类型。 |
TEXT_HTML |
text/html MIME 类型。 |
PDF |
application/pdf MIME 类型。 |
MSWORD |
application/msword MIME 类型。 |
MSEXCEL |
application/vnd.ms-excel 的 MIME 类型。 |
RTF |
application/rtf MIME 类型。 |
AUDIO_WAV |
MIME 类型 audio/wav。 |
AUDIO_MP3 |
MIME 类型 audio/mp3。 |
HTML5_AD_ZIP |
application/x-html5-ad-zip MIME 类型。 |
AdImageAsset
广告内使用的图片素材资源。
JSON 表示法 |
---|
{ "asset": string } |
字段 | |
---|---|
asset |
此图片的资产资源名称。 |
VideoAdInfo
视频广告。
JSON 表示法 |
---|
{ "video": { object ( |
字段 | |
---|---|
video |
广告中使用的 YouTube 视频素材资源。 |
联合字段 format 。不同视频格式所特有的格式架构。format 只能是下列其中一项: |
|
inStream |
视频 TrueView 插播广告格式。 |
bumper |
导视插播视频广告格式。 |
outStream |
视频外播广告格式。 |
nonSkippable |
不可跳过的插播广告格式。 |
inFeed |
信息流视频广告格式。 |
AdVideoAsset
广告内使用的视频素材资源。
JSON 表示法 |
---|
{ "asset": string } |
字段 | |
---|---|
asset |
此视频的资产资源名称。 |
VideoTrueViewInStreamAdInfo
表示视频 TrueView 插播广告格式(在视频播放期间,通常在开始播放时展示,会在视频播放几秒后显示“跳过”按钮的广告)。
JSON 表示法 |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
字段 | |
---|---|
actionButtonLabel |
号召性用语 (CTA) 按钮上的标签,可将用户引导至视频广告的最终到达网址。对于 TrueView 行动号召广告系列而言是必需的,否则为可选。 |
actionHeadline |
使用 CTA(号召性用语)按钮显示的额外文字,可提供背景信息并鼓励用户点击该按钮。 |
companionBanner |
与广告结合使用的随播横幅广告的图片素材资源。 |
VideoBumperInStreamAdInfo
导视插播视频广告格式(非常短的不可跳过的插播视频广告)呈现方式。
JSON 表示法 |
---|
{
"companionBanner": {
object ( |
字段 | |
---|---|
companionBanner |
与广告结合使用的随播横幅广告的图片素材资源。 |
actionButtonLabel |
“号召性用语”按钮上的标签,将用户引导至视频广告的最终到达网址。 |
actionHeadline |
使用 CTA(号召性用语)按钮显示的额外文字,可提供背景信息并鼓励用户点击该按钮。 |
VideoOutstreamAdInfo
外播视频广告格式的表示形式(在启用了自动播放功能的 Feed 旁展示,且无声音)。
JSON 表示法 |
---|
{ "headline": string, "description": string } |
字段 | |
---|---|
headline |
广告的标题。 |
description |
广告内容描述。 |
VideoNonSkippableInStreamAdInfo
不可跳过的插播广告格式(15 秒不可跳过的插播视频广告)的表示形式。
JSON 表示法 |
---|
{
"companionBanner": {
object ( |
字段 | |
---|---|
companionBanner |
与广告结合使用的随播横幅广告的图片素材资源。 |
actionButtonLabel |
“号召性用语”按钮上的标签,将用户引导至视频广告的最终到达网址。 |
actionHeadline |
通过“号召性用语”按钮显示的额外文字,提供了背景信息并鼓励用户点击该按钮。 |
InFeedVideoAdInfo
信息流视频广告格式的表示形式。
JSON 表示法 |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
字段 | |
---|---|
headline |
广告的标题。 |
description1 |
广告的第一行文字。 |
description2 |
广告的第二行文字。 |
thumbnail |
要使用的视频缩略图。 |
VideoThumbnail
列出可能的视频缩略图类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定类型。 |
UNKNOWN |
此版本中未知接收的值。这是一个仅用于响应的值。 |
DEFAULT_THUMBNAIL |
默认缩略图。可以自动生成或由用户上传。 |
THUMBNAIL_1 |
缩略图 1,由视频生成。 |
THUMBNAIL_2 |
缩略图 2,由视频生成。 |
THUMBNAIL_3 |
缩略图 3,由视频生成。 |
VideoResponsiveAdInfo
视频自适应广告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
用于短标题的文字素材资源列表。目前仅支持短标题的一个值。 |
longHeadlines[] |
用于长标题的文字素材资源列表。目前仅支持为长标题使用单个值。 |
descriptions[] |
用于说明的文字素材资源列表。目前仅支持一个说明值。 |
callToActions[] |
用于按钮的文字素材资源列表,例如“号召性用语”按钮。目前仅支持按钮的一个值。 |
videos[] |
广告所用 YouTube 视频素材资源的列表。目前,YouTube 视频素材资源仅支持单个值。 |
companionBanners[] |
用于随播横幅广告的图片素材资源列表。目前仅支持为随播横幅广告素材资源使用一个值。 |
breadcrumb1 |
广告中显示的文字的第一部分,包含显示网址。 |
breadcrumb2 |
广告中显示的文字的第二部分以及显示网址。 |
AdTextAsset
广告内使用的文字素材资源。
JSON 表示法 |
---|
{ "pinnedField": enum ( |
字段 | |
---|---|
pinnedField |
素材资源的固定字段。这会将素材资源限制为仅在此字段内投放。您可以将多个素材资源固定到同一字段。取消固定或固定到其他字段的素材资源将不会在已固定其他一些素材资源的字段中投放。 |
assetPerformanceLabel |
此文字素材资源的效果标签。 |
policySummaryInfo |
此文字素材资源的政策摘要。 |
text |
素材资源文字。 |
ServedAssetFieldType
可能的资产字段类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知接收的值。 这是一个仅用于响应的值。 |
HEADLINE_1 |
该素材资源用于标题 1。 |
HEADLINE_2 |
该素材资源用于标题 2。 |
HEADLINE_3 |
该素材资源用于标题 3。 |
DESCRIPTION_1 |
该素材资源用于广告内容描述 1。 |
DESCRIPTION_2 |
该素材资源用于广告内容描述 2。 |
HEADLINE |
该素材资源已在标题中使用。仅当广告中只有一个标题时,才应使用此过滤条件。否则,请使用 HEADLINE_1、HEADLINE_2 或 HEADLINE_3 枚举 |
HEADLINE_IN_PORTRAIT |
该素材资源曾用作纵向图片的标题。 |
LONG_HEADLINE |
该素材资源用在了长标题中(在 MultiAsset 自适应 Ad 中使用)。 |
DESCRIPTION |
该素材资源已用在说明中。仅当广告中只有一条广告内容描述时,才使用此列。否则,请使用 DESCRIPTION_1 或 DESCRIPTION_@ 枚举 |
DESCRIPTION_IN_PORTRAIT |
此素材资源已用作纵向图片中的说明。 |
BUSINESS_NAME_IN_PORTRAIT |
该素材资源在纵向图片中用作了商家名称。 |
BUSINESS_NAME |
该素材资源被用作了商家名称。 |
MARKETING_IMAGE |
该素材资源已用作营销图片。 |
MARKETING_IMAGE_IN_PORTRAIT |
该素材资源被用作纵向图片的营销图片。 |
SQUARE_MARKETING_IMAGE |
该素材资源被用作了方形营销图片。 |
PORTRAIT_MARKETING_IMAGE |
该素材资源被用作了纵向营销图片。 |
LOGO |
此素材资源已用作徽标。 |
LANDSCAPE_LOGO |
此素材资源被用作了横向徽标。 |
CALL_TO_ACTION |
该素材资源已用作号召性用语。 |
YOU_TUBE_VIDEO |
该资产曾用作 YouTube 视频。 |
SITELINK |
此素材资源将用作站内链接。 |
CALL |
此素材资源用作电话素材资源。 |
MOBILE_APP |
此素材资源用作移动应用。 |
CALLOUT |
此素材资源将用作宣传信息。 |
STRUCTURED_SNIPPET |
此素材资源已用作结构化摘要。 |
PRICE |
此素材资源用作价格。 |
PROMOTION |
此素材资源将用作促销信息。 |
AD_IMAGE |
此素材资源目前用作图片。 |
LEAD_FORM |
该素材资源将用作潜在客户表单。 |
BUSINESS_LOGO |
此素材资源已用作商家徽标。 |
AssetPerformanceLabel
描述资产可能性能标签的枚举,通常在关联上下文中计算。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PENDING |
此素材资源尚无任何效果信息。导致这种情况的原因可能是:该商品仍在审核中。 |
LEARNING |
素材资源已开始获得展示,但统计数据没有太大意义,无法获得素材资源效果标签。 |
LOW |
效果最差的素材资源。 |
GOOD |
效果出色的素材资源。 |
BEST |
效果最佳的素材资源。 |
AdAssetPolicySummary
包含广告内某项素材资源的政策信息。
JSON 表示法 |
---|
{ "policyTopicEntries": [ { object ( |
字段 | |
---|---|
policyTopicEntries[] |
此资产的政策发现结果列表。 |
reviewStatus |
此素材资源在审核过程中的哪个阶段。 |
approvalStatus |
此素材资源的整体审批状态,根据其各个政策主题条目的状态计算得出。 |
PolicyTopicEntry
与资源关联的政策发现结果(例如,与销售酒精饮料的网站相关的酒精饮料政策)。
每个 PolicyTopicEntry 都有一个主题,用于指明相应条目涉及的具体广告政策,以及用于指明相应条目将对广告投放产生的影响的类型。它可能有一个或多个证据,可表明出现此发现结果的原因。还可以选择具有一个或多个限制条件,用于详细说明如何限制广告投放。
JSON 表示法 |
---|
{ "type": enum ( |
字段 | |
---|---|
type |
描述此政策会对广告投放产生的负面影响或积极影响。 |
evidences[] |
用于解释发现结果的其他信息(例如,商标发现结果的品牌名称)。 |
constraints[] |
指明此资源的投放可能会受到怎样的影响(例如,不在某个国家/地区投放)。 |
topic |
此发现结果涉及的政策主题。例如,“ALCOHOL”“TRADEMARKS_IN_AD_TEXT”或“DESTINATION_NOT_WORKING”。可能的政策主题集不是针对特定 API 版本固定的,可能随时发生更改。 |
PolicyTopicEntryType
可能的政策主题条目类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知接收的值。 这是一个仅用于响应的值。 |
PROHIBITED |
将不会提供该资源。 |
LIMITED |
在某些情况下,系统不会提供相应资源。 |
FULLY_LIMITED |
受当前的定位条件约束,该资源根本无法投放。 |
DESCRIPTIVE |
您可能会感兴趣,但不会限制资源的提供方式。 |
BROADENING |
可能会超出正常覆盖面。 |
AREA_OF_INTEREST_ONLY |
在所有目标国家/地区受到限制,但可能会通过关注区域在其他国家/地区投放。 |
PolicyTopicEvidence
用于解释政策发现结果的其他信息。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 value 。具体证据信息(取决于证据类型)。value 只能是下列其中一项: |
|
websiteList |
与此资源关联的网站的列表。 |
textList |
在资源文本中发现的证据列表。 |
languageCode |
检测到编写资源时使用的语言。这是 IETF 语言标记,例如“en-US”。 |
destinationTextList |
导致政策发现结果的资源目标位置中的文本。 |
destinationMismatch |
资源网址的目标页面不匹配。 |
destinationNotWorking |
详细说明目的地何时返回 HTTP 错误代码,或并非在所有常用设备都正常运行。 |
WebsiteList
导致系统发现违规问题的网站列表。例如,用于 ONE_WEBSITE_PER_AD_GROUP 政策主题。如果网站数量超过五个,则此处只会列出前五个网站(资源中最常出现的网站)。
JSON 表示法 |
---|
{ "websites": [ string ] } |
字段 | |
---|---|
websites[] |
导致违规的网站。 |
TextList
违反政策的文本片段的列表。
JSON 表示法 |
---|
{ "texts": [ string ] } |
字段 | |
---|---|
texts[] |
资源中导致政策发现结果的文本片段。 |
DestinationTextList
在目标网页中找到的导致政策发现结果的字符串列表。
JSON 表示法 |
---|
{ "destinationTexts": [ string ] } |
字段 | |
---|---|
destinationTexts[] |
在资源的目标页面中发现的文本列表。 |
DestinationMismatch
资源网址不匹配的证据。
JSON 表示法 |
---|
{
"urlTypes": [
enum ( |
字段 | |
---|---|
urlTypes[] |
彼此不匹配的网址集。 |
PolicyTopicEvidenceDestinationMismatchUrlType
可能的政策主题证据:目标页面的网址类型不匹配。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知接收的值。 这是一个仅用于响应的值。 |
DISPLAY_URL |
显示网址。 |
FINAL_URL |
最终到达网址。 |
FINAL_MOBILE_URL |
最终到达移动网址。 |
TRACKING_URL |
跟踪网址模板(包含经过替换的桌面版网址)。 |
MOBILE_TRACKING_URL |
跟踪网址模板(包含经过替换的移动网址)。 |
DestinationNotWorking
当目标位置返回 HTTP 错误代码或并非在所有常用设备上正常运行时,可提供相关证据的详细信息。
JSON 表示法 |
---|
{ "device": enum ( |
字段 | |
---|---|
device |
未能加载网址的设备类型。 |
expandedUrl |
无法访问的完整网址。 |
lastCheckedDateTime |
上次检查网址的时间。其格式为“YYYY-MM-DD HH:MM:SS”。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
联合字段 reason 。指示发现 DESTINATION_NOT_WORKING 政策结果的原因。reason 只能是下列其中一项: |
|
dnsErrorType |
DNS 错误的类型。 |
httpErrorCode |
HTTP 错误代码。 |
PolicyTopicEvidenceDestinationNotWorkingDevice
可能的政策主题证据的目标位置设备无法正常运行。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知接收的值。 这是一个仅用于响应的值。 |
DESKTOP |
着陆页在桌面设备上无法正常运行。 |
ANDROID |
着陆页无法在 Android 设备上显示。 |
IOS |
着陆页无法在 iOS 设备上显示。 |
PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
可能的政策主题证据的“目标页面无效”DNS 错误类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知接收的值。 这是一个仅用于响应的值。 |
HOSTNAME_NOT_FOUND |
提取着陆页时,DNS 中找不到主机名。 |
GOOGLE_CRAWLER_DNS_ISSUE |
与 DNS 通信时出现 Google 内部抓取工具问题。此错误并不意味着着陆页无法正常运作。Google 会重新抓取着陆页。 |
PolicyTopicConstraint
描述政策主题条目对服务的影响。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 value 。有关限制条件的具体信息。value 只能是下列其中一项: |
|
countryConstraintList |
无法投放资源的国家/地区。 |
resellerConstraint |
转销商限制条件。 |
certificateMissingInCountryList |
需要有证书才能投放广告的国家/地区。 |
certificateDomainMismatchInCountryList |
资源的网域不在与其关联的证书涵盖的国家/地区。 |
CountryConstraintList
资源服务受限的国家/地区列表。
JSON 表示法 |
---|
{
"countries": [
{
object ( |
字段 | |
---|---|
countries[] |
广告投放受限的国家/地区。 |
totalTargetedCountries |
资源定位的国家/地区总数。 |
CountryConstraint
表示资源在特定国家/地区的服务能力受到限制。
JSON 表示法 |
---|
{ "countryCriterion": string } |
字段 | |
---|---|
countryCriterion |
广告投放受限的国家/地区的地理位置定位常量资源名称。 |
ResellerConstraint
此类型没有任何字段。
表示政策主题由于为转销商而被拒登的网站而受到约束。
PolicyReviewStatus
可能的政策审核状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知接收的值。 这是一个仅用于响应的值。 |
REVIEW_IN_PROGRESS |
目前正在审核中。 |
REVIEWED |
主要审核已完成。其他审核可能仍在进行。 |
UNDER_APPEAL |
已重新提交该资源以供审批,或已就其违规认定提出申诉。 |
ELIGIBLE_MAY_SERVE |
资源符合条件,可能正在投放,但仍可能接受进一步审核。 |
PolicyApprovalStatus
可能的政策审批状态。当有多种审批状态时,系统将采用最严重的一种。严重级别分别为 DISAPPROVED、AREA_OF_INTEREST_ONLY、APPROVED_LIMITED 和 APPROVED。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知接收的值。 这是一个仅用于响应的值。 |
DISAPPROVED |
将不会投放。 |
APPROVED_LIMITED |
有限制条件。 |
APPROVED |
可不受限制地投放。 |
AREA_OF_INTEREST_ONLY |
不会在目标国家/地区投放,但可能会面向搜索目标国家/地区相关信息的用户投放。 |
ResponsiveSearchAdInfo
自适应搜索广告。
采用自适应搜索广告格式制作广告,可以根据客户的搜索字词向其展示更丰富的文字信息以及更切实相关的广告内容。制作自适应搜索广告时,您只需输入多个标题和广告内容描述即可;随着时间的推移,Google Ads 会自动测试各种不同的组合,通过机器学习技术逐渐摸索出效果最好的组合。自适应搜索广告可以动态调整广告的内容,使其更贴近潜在客户的搜索字词,从而提升广告系列的效果。
有关更多信息,请访问 https://support.google.com/google-ads/answer/7684791
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 |
descriptions[] |
说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 |
path1 |
可以附加到广告中网址的第一部分。 |
path2 |
可以附加到广告中网址的第二部分文字。只有在同时设置了 |
LegacyResponsiveDisplayAdInfo
旧版自适应展示广告。此类广告在 Google Ads 界面中标记为“自适应广告”。
JSON 表示法 |
---|
{
"formatSetting": enum ( |
字段 | |
---|---|
formatSetting |
指定投放广告采用的格式。默认为 ALL_FORMAT。 |
shortHeadline |
短版本的广告标题。 |
longHeadline |
长版本的广告标题。 |
description |
广告的广告内容描述。 |
businessName |
广告中的商家名称。 |
allowFlexibleColor |
广告主同意使用灵活的颜色。如果为 true,则系统可根据需要以不同颜色投放广告。如果为 false,则系统会以指定颜色或中性颜色投放广告。默认值为 |
accentColor |
广告的强调色,采用十六进制格式,例如 #ffffff 表示白色。如果设置了 |
mainColor |
广告的主颜色,以十六进制格式表示,例如 #ffffff 表示白色。如果设置了 |
callToActionText |
广告的号召性用语。 |
logoImage |
广告中使用的徽标图片的 MediaFile 资源名称。 |
squareLogoImage |
广告中使用的方形徽标图片的 MediaFile 资源名称。 |
marketingImage |
广告中使用的营销图片的 MediaFile 资源名称。 |
squareMarketingImage |
广告中使用的方形营销图片的 MediaFile 资源名称。 |
pricePrefix |
价格之前的前缀。例如,“低至”。 |
promoText |
用于动态格式自适应广告的宣传文字。例如,“两日运费免费”。 |
DisplayAdFormatSetting
枚举展示广告格式设置。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
在此版本中,此值未知。 |
ALL_FORMATS |
文字、图片和原生广告格式。 |
NON_NATIVE |
文字和图片格式。 |
NATIVE |
例如,原生格式呈现由发布商控制,而不是由 Google 控制。 |
AppAdInfo
应用广告。
JSON 表示法 |
---|
{ "mandatoryAdText": { object ( |
字段 | |
---|---|
mandatoryAdText |
必填广告文字。 |
headlines[] |
标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 |
descriptions[] |
说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 |
images[] |
可以与广告一起展示的图片素材资源列表。 |
youtubeVideos[] |
可与广告一起展示的 YouTube 视频素材资源列表。 |
html5MediaBundles[] |
可与广告一起使用的媒体包素材资源列表。 |
AdMediaBundleAsset
广告内使用的媒体包素材资源。
JSON 表示法 |
---|
{ "asset": string } |
字段 | |
---|---|
asset |
此媒体包的资产资源名称。 |
LegacyAppInstallAdInfo
只有少数特定客户使用的旧版应用安装广告。
JSON 表示法 |
---|
{
"appStore": enum ( |
字段 | |
---|---|
appStore |
提供移动应用的应用商店。 |
appId |
移动应用的 ID。 |
headline |
广告的标题。 |
description1 |
广告的第 1 行广告内容描述。 |
description2 |
广告的第 2 行广告内容描述。 |
LegacyAppInstallAdAppStore
旧版应用安装广告中的应用商店类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
APPLE_APP_STORE |
Apple iTunes。 |
GOOGLE_PLAY |
Google Play。 |
WINDOWS_STORE |
Windows 应用商店。 |
WINDOWS_PHONE_STORE |
Windows Phone Store。 |
CN_APP_STORE |
该应用托管在中国应用商店中。 |
ResponsiveDisplayAdInfo
自适应展示广告。
JSON 表示法 |
---|
{ "marketingImages": [ { object ( |
字段 | |
---|---|
marketingImages[] |
要在广告中使用的营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 600x314,宽高比必须为 1.91:1 (+-1%)。至少需要提供一个 |
squareMarketingImages[] |
要在广告中使用的方形营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 300x300,宽高比必须为 1:1 (+-1%)。至少需要一个方形 |
logoImages[] |
要在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 512x128,宽高比必须为 4:1 (+-1%)。如果与 |
squareLogoImages[] |
要在广告中使用的正方形徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。如果与 |
headlines[] |
广告的短格式标题。最大长度为 30 个字符。可以指定至少 1 个和最多 5 个标题。 |
longHeadline |
必需的长格式标题。最大长度为 90 个字符。 |
descriptions[] |
广告的描述性文字。最大长度为 90 个字符。可以指定至少 1 个和最多 5 个标题。 |
youtubeVideos[] |
(可选)广告的 YouTube 视频。最多可以指定 5 个视频。 |
formatSetting |
指定投放广告采用的格式。默认为 ALL_FORMAT。 |
controlSpec |
各种广告素材控制的规范。 |
businessName |
广告主/品牌名称。最大展示宽度为 25。 |
mainColor |
广告的主颜色,以十六进制格式表示,例如 #ffffff 表示白色。如果设置了 |
accentColor |
广告的强调色,采用十六进制格式,例如 #ffffff 表示白色。如果设置了 |
allowFlexibleColor |
广告主同意使用灵活的颜色。如果为 true,则系统可根据需要以不同颜色投放广告。如果为 false,则系统会以指定颜色或中性颜色投放广告。默认值为 |
callToActionText |
广告的号召性用语文字。最大展示宽度为 30。 |
pricePrefix |
价格之前的前缀。例如,“低至”。 |
promoText |
用于动态格式自适应广告的宣传文字。例如,“两日运费免费”。 |
ResponsiveDisplayAdControlSpec
自适应展示广告的各种广告素材控制规范。
JSON 表示法 |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
字段 | |
---|---|
enableAssetEnhancements |
广告客户是否已选择启用素材资源自动美化功能。 |
enableAutogenVideo |
广告主是否已选择启用自动生成视频功能。 |
LocalAdInfo
本地广告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
标题的文字素材资源列表。在投放广告时,系统会从此列表中选择标题。必须至少指定 1 个、最多 5 个标题。 |
descriptions[] |
说明的文字素材资源列表。在投放广告时,系统会从此列表中选择广告内容描述。必须至少指定 1 到 5 项广告内容描述。 |
callToActions[] |
号召性用语的文字素材资源列表。在广告投放时,系统会从此列表中选择号召性用语。必须至少指定 1 个、最多 5 个号召性用语。 |
marketingImages[] |
可与广告一起展示的营销图片素材资源列表。图片必须为 314x600 像素或 320x320 像素。必须至少指定 1 到 20 项图片素材资源。 |
logoImages[] |
可随广告一起展示的徽标图片素材资源的列表。图片必须为 128x128 像素,且不得超过 120KB。必须至少指定 1 到 5 项图片素材资源。 |
videos[] |
可与广告一起展示的 YouTube 视频素材资源的列表。必须指定至少 1 到 20 项视频素材资源。 |
path1 |
可附加到广告中网址的可选文字的第一部分。 |
path2 |
可附加到广告中网址的可选文字的第二部分。只有在同时设置了 |
DisplayUploadAdInfo
通用类型的展示广告。确切的广告格式由 displayUploadProductType
字段控制,该字段决定了广告需要包含哪些类型的数据。
JSON 表示法 |
---|
{ "displayUploadProductType": enum ( |
字段 | |
---|---|
displayUploadProductType |
此广告的产品类型。如需了解详情,请参阅枚举的注释。 |
联合字段 media_asset 。构成广告的素材资源数据。media_asset 只能是下列其中一项: |
|
mediaBundle |
要在广告中使用的媒体包素材资源。要了解适用于 HTML5_UPLOAD_AD 的媒体包,请参阅 https://support.google.com/google-ads/answer/1722096 属于动态产品类型的媒体包使用一种需要通过 Google Web Designer 创建的特殊格式。如需了解详情,请参阅 https://support.google.com/webdesigner/answer/7543898。 |
DisplayUploadProductType
枚举展示广告上传产品类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
在此版本中,此值未知。 |
HTML5_UPLOAD_AD |
上传 HTML5 广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。 |
DYNAMIC_HTML5_EDUCATION_AD |
动态 HTML5 教育广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于教育广告系列。 |
DYNAMIC_HTML5_FLIGHT_AD |
动态 HTML5 排期广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能在短期集中投放的广告系列中使用。 |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
动态 HTML5 酒店及房屋租赁广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能在酒店广告系列中使用。 |
DYNAMIC_HTML5_JOB_AD |
动态 HTML5 求职招聘广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能在求职广告系列中使用。 |
DYNAMIC_HTML5_LOCAL_AD |
动态 HTML5 本地广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能在本地广告系列中使用。 |
DYNAMIC_HTML5_REAL_ESTATE_AD |
动态 HTML5 房地产广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能在房地产广告系列中使用。 |
DYNAMIC_HTML5_CUSTOM_AD |
动态 HTML5 自定义广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能在自定义广告系列中使用。 |
DYNAMIC_HTML5_TRAVEL_AD |
动态 HTML5 旅游广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能在旅游广告系列中使用。 |
DYNAMIC_HTML5_HOTEL_AD |
动态 HTML5 酒店广告。此商品类型要求设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能在酒店广告系列中使用。 |
AppEngagementAdInfo
利用应用互动广告,您可以撰写旨在鼓励用户采取特定应用内操作(比如登记、购买或预订机票)的文字。通过发现广告,您可以将用户引导至应用的特定部分,以便他们更加轻松快捷地找到所需内容。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 |
descriptions[] |
说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 |
images[] |
可以与广告一起展示的图片素材资源列表。 |
videos[] |
可与广告一起展示的视频素材资源的列表。 |
ShoppingComparisonListingAdInfo
比价购物广告。
JSON 表示法 |
---|
{ "headline": string } |
字段 | |
---|---|
headline |
广告的标题。必须填写此字段。允许的长度介于 25 到 45 个字符之间。 |
SmartCampaignAdInfo
智能广告系列中的广告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
文字素材资源列表,其中每项素材资源都与广告投放时的一个标题相对应。此列表包含至少 3 到 15 个文字素材资源。 |
descriptions[] |
文字素材资源列表,其中每项素材资源在广告投放时均对应一条广告内容描述。此列表包含至少 2 到 4 个文字素材资源。 |
AppPreRegistrationAdInfo
应用预注册广告会链接到您在 Google Play 上的应用或游戏详情,并可在 Google Play、YouTube(仅限插播广告)以及展示广告网络中的其他应用和移动网站上投放。这有助于激发用户对应用或游戏的兴趣,并在应用或游戏发布前预先吸引安装群体。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 |
descriptions[] |
说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 |
images[] |
图片素材资源 ID 列表,其中的图片可与广告一起展示。 |
youtubeVideos[] |
可与广告一起展示的 YouTube 视频素材资源 ID 列表。 |
DiscoveryMultiAssetAdInfo
多素材资源发现广告。
JSON 表示法 |
---|
{ "marketingImages": [ { object ( |
字段 | |
---|---|
marketingImages[] |
要在广告中使用的营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 600x314,宽高比必须为 1.91:1 (+-1%)。如果不存在 squareMarketingImages,则必须填写此字段。与 |
squareMarketingImages[] |
要在广告中使用的方形营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 300x300,宽高比必须为 1:1 (+-1%)。如果 marketingImages 不存在,则为必填。与 |
portraitMarketingImages[] |
要在广告中使用的纵向营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 480x600,宽高比必须为 4:5 (+-1%)。与 |
logoImages[] |
要在广告中使用的徽标图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。可以指定至少 1 张、最多 5 张徽标图片。 |
headlines[] |
广告的标题文字素材资源。显示屏宽度上限为 30。可以指定至少 1 个和最多 5 个标题。 |
descriptions[] |
广告的描述性文字。显示屏宽度上限为 90。可以指定至少 1 到 5 项广告内容描述。 |
businessName |
广告客户/品牌名称。显示屏宽度上限为 25。必填。 |
callToActionText |
号召性用语文字。 |
leadFormOnly |
指明此广告是否必须与潜在客户表单一起投放的布尔值选项。 |
DiscoveryCarouselAdInfo
轮播式发现广告。
JSON 表示法 |
---|
{ "businessName": string, "logoImage": { object ( |
字段 | |
---|---|
businessName |
必需。广告客户/品牌名称。 |
logoImage |
必需。要在广告中使用的徽标图片。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。 |
headline |
必需。广告的标题。 |
description |
必需。广告的描述性文字。 |
callToActionText |
号召性用语文字。 |
carouselCards[] |
必需。将与广告一起展示的轮播卡片。最小值 2 最大值 10。 |
AdDiscoveryCarouselCardAsset
在广告中使用的轮播式发现广告卡片素材资源。
JSON 表示法 |
---|
{ "asset": string } |
字段 | |
---|---|
asset |
此轮播式发现广告卡片的资产资源名称。 |
DiscoveryVideoResponsiveAdInfo
视频发现广告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
字段 | |
---|---|
headlines[] |
用于短标题的文字素材资源列表。 |
longHeadlines[] |
用于长标题的文字素材资源列表。 |
descriptions[] |
用于说明的文字素材资源列表。 |
videos[] |
广告所用 YouTube 视频素材资源的列表。 |
logoImages[] |
要在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。 |
breadcrumb1 |
广告中显示的文字的第一部分,包含显示网址。 |
breadcrumb2 |
广告中显示的文字的第二部分以及显示网址。 |
businessName |
必需。广告客户/品牌名称。 |
callToActions[] |
用于“号召性用语”按钮的 CallToActionAsset 类型的素材资源。 |
AdCallToActionAsset
在广告中使用的号召性用语素材资源。
JSON 表示法 |
---|
{ "asset": string } |
字段 | |
---|---|
asset |
此号召性用语素材资源的素材资源资源名称。 |
TravelAdInfo
此类型没有任何字段。
旅游广告。
方法 |
|
---|---|
|
返回所请求的完整详情。 |
|
更新广告。 |