- JSON 表示法
- AssetType
- AssetPolicySummary
- AssetFieldTypePolicySummary
- YoutubeVideoAsset
- MediaBundleAsset
- ImageAsset
- ImageDimension
- TextAsset
- LeadFormAsset
- LeadFormCallToActionType
- LeadFormField
- LeadFormSingleChoiceAnswers
- LeadFormCustomQuestionField
- LeadFormDeliveryMethod
- WebhookDelivery
- LeadFormPostSubmitCallToActionType
- LeadFormDesiredIntent
- BookOnGoogleAsset
- PromotionAsset
- CalloutAsset
- StructuredSnippetAsset
- SitelinkAsset
- PageFeedAsset
- DynamicEducationAsset
- MobileAppAsset
- HotelCalloutAsset
- CallAsset
- PriceAsset
- PriceOffering
- CallToActionAsset
- DynamicRealEstateAsset
- DynamicCustomAsset
- DynamicHotelsAndRentalsAsset
- DynamicFlightsAsset
- DiscoveryCarouselCardAsset
- DynamicTravelAsset
- DynamicLocalAsset
- DynamicJobsAsset
- LocationAsset
- BusinessProfileLocation
- HotelPropertyAsset
素材资源是广告的组成部分,可以在多个广告之间共享。可以是图片 (ImageAsset)、视频 (YoutubeVideoAsset) 等。素材资源不可更改,不能移除。如需停止投放某个素材资源,请从使用该素材资源的实体中移除该素材资源。
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resourceName |
不可变。资产的资源名称。资源资源名称采用以下格式:
|
type |
仅供输出。资产的类型。 |
finalUrls[] |
经过所有跨网域重定向后可能出现的最终到达网址的列表。 |
finalMobileUrls[] |
包含所有跨网域重定向后可能的最终到达移动网址的列表。 |
urlCustomParameters[] |
映射列表,用于替换 trackingUrlTemplate、FinalUrls 和/或 finalMobileUrls 中的网址自定义参数代码。 |
source |
仅供输出。资产的来源。 |
policySummary |
仅供输出。资产的政策信息。 |
fieldTypePolicySummaries[] |
仅供输出。每个 FieldType 的资产的政策信息。 |
id |
仅供输出。素材资源的 ID。 |
name |
资源的可选名称。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。 |
finalUrlSuffix |
用于将参数附加到通过并行跟踪投放的着陆页网址的网址模板。 |
联合字段 asset_data 。资产的具体类型。asset_data 只能是下列其中一项: |
|
youtubeVideoAsset |
不可变。YouTube 视频素材资源。 |
mediaBundleAsset |
不可变。媒体包素材资源。 |
imageAsset |
仅供输出。图片素材资源。 |
textAsset |
不可变。文字素材资源。 |
leadFormAsset |
潜在客户表单素材资源。 |
bookOnGoogleAsset |
Google 上的图书素材资源。 |
promotionAsset |
促销信息素材资源。 |
calloutAsset |
宣传信息素材资源。 |
structuredSnippetAsset |
结构化摘要素材资源。 |
sitelinkAsset |
站内链接素材资源。 |
pageFeedAsset |
页面 Feed 素材资源。 |
dynamicEducationAsset |
动态教育素材资源。 |
mobileAppAsset |
移动应用素材资源。 |
hotelCalloutAsset |
酒店宣传信息素材资源。 |
callAsset |
电话素材资源。 |
priceAsset |
价格素材资源。 |
callToActionAsset |
不可变。号召性用语素材资源。 |
dynamicRealEstateAsset |
动态房地产素材资源。 |
dynamicCustomAsset |
动态自定义素材资源。 |
dynamicHotelsAndRentalsAsset |
动态酒店及房屋租赁素材资源。 |
dynamicFlightsAsset |
动态航班素材资源。 |
discoveryCarouselCardAsset |
不可变。轮播式发现广告卡片素材资源。 |
dynamicTravelAsset |
动态旅游素材资源。 |
dynamicLocalAsset |
动态本地素材资源。 |
dynamicJobsAsset |
动态招聘信息素材资源。 |
locationAsset |
仅供输出。地址素材资源。 |
hotelPropertyAsset |
不可变。酒店房源素材资源。 |
AssetType
描述可能的资产类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
YOUTUBE_VIDEO |
YouTube 视频素材资源。 |
MEDIA_BUNDLE |
媒体包素材资源。 |
IMAGE |
图片素材资源。 |
TEXT |
文字素材资源。 |
LEAD_FORM |
潜在客户表单素材资源。 |
BOOK_ON_GOOGLE |
“通过 Google 预订”素材资源。 |
PROMOTION |
促销信息素材资源。 |
CALLOUT |
宣传信息素材资源。 |
STRUCTURED_SNIPPET |
结构化摘要素材资源。 |
SITELINK |
站内链接素材资源。 |
PAGE_FEED |
页面 Feed 素材资源。 |
DYNAMIC_EDUCATION |
动态教育素材资源。 |
MOBILE_APP |
移动应用素材资源。 |
HOTEL_CALLOUT |
酒店宣传信息素材资源。 |
CALL |
电话素材资源。 |
PRICE |
价格素材资源。 |
CALL_TO_ACTION |
号召性用语素材资源。 |
DYNAMIC_REAL_ESTATE |
动态房地产素材资源。 |
DYNAMIC_CUSTOM |
动态自定义素材资源。 |
DYNAMIC_HOTELS_AND_RENTALS |
动态酒店及房屋租赁素材资源。 |
DYNAMIC_FLIGHTS |
动态航班素材资源。 |
DISCOVERY_CAROUSEL_CARD |
轮播式发现广告卡片素材资源。 |
DYNAMIC_TRAVEL |
动态旅行素材资源。 |
DYNAMIC_LOCAL |
动态本地素材资源。 |
DYNAMIC_JOBS |
动态招聘信息素材资源。 |
LOCATION |
地址素材资源。 |
HOTEL_PROPERTY |
酒店房源素材资源。 |
AssetPolicySummary
包含资产的政策信息。
JSON 表示法 |
---|
{ "policyTopicEntries": [ { object ( |
字段 | |
---|---|
policyTopicEntries[] |
仅供输出。此资产的政策发现结果列表。 |
reviewStatus |
仅供输出。此素材资源在审核过程中所处的阶段。 |
approvalStatus |
仅供输出。此素材资源的整体审批状态,根据其各个政策主题条目的状态计算得出。 |
AssetFieldTypePolicySummary
包含 AssetFieldType 上下文下的资产的政策信息。
JSON 表示法 |
---|
{ "assetFieldType": enum ( |
字段 | |
---|---|
assetFieldType |
仅供输出。此资产的 FieldType。 |
assetSource |
仅供输出。此资产的来源。 |
policySummaryInfo |
仅供输出。政策摘要。 |
YoutubeVideoAsset
YouTube 资产。
JSON 表示法 |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
字段 | |
---|---|
youtubeVideoTitle |
YouTube 视频标题。 |
youtubeVideoId |
YouTube 视频 ID。这是在 YouTube 视频网址中使用的 11 个字符的字符串值。 |
MediaBundleAsset
MediaBundle 素材资源。
JSON 表示法 |
---|
{ "data": string } |
字段 | |
---|---|
data |
媒体包(ZIP 文件)素材资源数据。上传的 ZIP 文件的格式取决于将要使用该文件的广告字段。如需详细了解此格式,请参阅您计划在其中使用 MediaBundleAsset 的广告字段的文档。此字段只进行了 mutate 操作。 使用 base64 编码的字符串。 |
ImageAsset
图片素材资源。
JSON 表示法 |
---|
{ "mimeType": enum ( |
字段 | |
---|---|
mimeType |
图片资源的 MIME 类型。 |
fullSize |
此图片以原始大小显示的元数据。 |
data |
图片的原始字节数据。此字段只进行了 mutate 操作。 使用 base64 编码的字符串。 |
fileSize |
图片资源的文件大小(以字节为单位)。 |
ImageDimension
特定尺寸的图片的元数据,可以是原始图片,也可以是调整大小后的图片。
JSON 表示法 |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
字段 | |
---|---|
heightPixels |
图片的高度。 |
widthPixels |
图片的宽度。 |
url |
可返回具有指定高度和宽度的图片的网址。 |
TextAsset
文字素材资源。
JSON 表示法 |
---|
{ "text": string } |
字段 | |
---|---|
text |
文字素材资源的文字内容。 |
LeadFormAsset
潜在客户表单素材资源。
JSON 表示法 |
---|
{ "businessName": string, "callToActionType": enum ( |
字段 | |
---|---|
businessName |
必需。所宣传企业的名称。 |
callToActionType |
必需。鼓励用户展开表单的预定义显示文本。 |
callToActionDescription |
必需。用于明确价值主张的文字,让用户在展开表单后会获得怎样的体验。 |
headline |
必需。展开的表单的标题,用于描述表单请求或协助提供的内容。 |
description |
必需。展开表单的详细说明,以说明表单要求或协助提供的内容。 |
privacyPolicyUrl |
必需。指向有关广告客户/商家如何处理所收集数据的政策的页面的链接。 |
fields[] |
有序的输入字段列表。可通过对问题重新排序来更新此字段,但不能通过添加或移除问题来更新此字段。 |
customQuestionFields[] |
自定义问题字段的有序列表。此字段最多只能包含 5 个甄别问题。 |
deliveryMethods[] |
已配置的方法,将收集的潜在客户数据传送给广告客户。只能配置一个类型为 WebhookDelivery 的方法。 |
postSubmitCallToActionType |
鼓励用户在提交表单后操作的预定义显示文本。 |
desiredIntent |
为潜在客户表单选择了意向,例如“更多”或“更符合条件”。 |
postSubmitHeadline |
提交表单后显示的文字标题,用于说明广告主将如何跟进用户。 |
postSubmitDescription |
表单提交后显示的详细说明,用于说明广告主将如何与用户取得联系。 |
backgroundImageAsset |
背景图片的资源资源名称。图片尺寸必须为 1200x628。 |
customDisclosure |
在潜在客户表单上与 Google 免责声明一起显示自定义披露信息。仅限获得许可的客户访问。 |
LeadFormCallToActionType
描述潜在客户表单中号召性用语类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
LEARN_MORE |
了解详情。 |
GET_QUOTE |
获取报价。 |
APPLY_NOW |
立即申请。 |
SIGN_UP |
注册。 |
CONTACT_US |
与我们联系。 |
SUBSCRIBE |
订阅。 |
DOWNLOAD |
下载。 |
BOOK_NOW |
立即预订。 |
GET_OFFER |
领取优惠。 |
REGISTER |
注册。 |
GET_INFO |
获取信息。 |
REQUEST_DEMO |
申请演示。 |
JOIN_NOW |
立即加入。 |
GET_STARTED |
开始使用 |
LeadFormField
表单中的一个输入字段实例。
JSON 表示法 |
---|
{ "inputType": enum ( |
字段 | |
---|---|
inputType |
描述输入类型,可以是预定义的类型(如“全名”)或经过预先审查的问题(如“您拥有哪种车辆?”)。 |
联合字段 answers 。定义此表单字段接受的答案配置。如果未设置其中任何一项,则为自由文本答案。answers 只能是下列其中一项: |
|
singleChoiceAnswers |
单选题的答案配置。只能为预先审查的问题字段设置此字段。至少需要 2 个答案,最多 12 个。 |
hasLocationAnswer |
位置问题的回答配置。如果为 true,广告系列/帐号一级的位置数据(州、城市、商家名称等)将在潜在客户表单中呈现。从 V13.1 开始,对于在广告系列/账号一级设置了地址素材资源的广告客户,只能针对“您的首选经销商是哪里?”问题设置 hasLocationAnswer。 |
LeadFormSingleChoiceAnswers
定义单选题的可能答案,通常以单选下拉列表的形式呈现。
JSON 表示法 |
---|
{ "answers": [ string ] } |
字段 | |
---|---|
answers[] |
单个问题字段的选项列表。条目的顺序定义了界面顺序。至少需要 2 个答案,最多 12 个。 |
LeadFormCustomQuestionField
表单内有一个自定义问题输入字段实例。
JSON 表示法 |
---|
{ "customQuestionText": string, // Union field |
字段 | |
---|---|
customQuestionText |
确切的自定义问题字段文本(例如“What kind of vehicle do you have?”)。 |
联合字段 answers 。定义此表单字段接受的答案配置。如果未设置其中任何一项,则为自由文本答案。answers 只能是下列其中一项: |
|
singleChoiceAnswers |
单选题的答案配置。回答最少 2 个,最多 12 个。 |
hasLocationAnswer |
位置问题的回答配置。如果为 true,广告系列/帐号一级的位置数据(州、城市、商家名称等)将在潜在客户表单中呈现。从 V13.1 开始,对于在广告系列/账号一级设置了地址素材资源的广告客户,只能针对“您的首选经销商是哪里?”问题设置 hasLocationAnswer。 |
LeadFormDeliveryMethod
配置如何向广告客户提供潜在客户信息。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 delivery_details 。投放的各种子类型。delivery_details 只能是下列其中一项: |
|
webhook |
Webhook 传送方法。 |
WebhookDelivery
Google 通过向广告主指定的端点发出 HTTP 调用来通知广告主存在潜在客户信息。这些请求包含与 Google 在表单广告文档中发布的架构匹配的 JSON。
JSON 表示法 |
---|
{ "advertiserWebhookUrl": string, "googleSecret": string, "payloadSchemaVersion": string } |
字段 | |
---|---|
advertiserWebhookUrl |
广告客户指定的网络钩子网址,用于发送潜在客户信息。 |
googleSecret |
广告客户在 webhook 载荷中设置的反欺骗密钥。 |
payloadSchemaVersion |
此交付实例将使用的架构版本。 |
LeadFormPostSubmitCallToActionType
描述潜在客户表单的致谢号召性用语类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
VISIT_SITE |
访问网站。 |
DOWNLOAD |
下载。 |
LEARN_MORE |
了解详情。 |
SHOP_NOW |
立即选购。 |
LeadFormDesiredIntent
描述所发掘潜在客户的所选意向级别的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
LOW_INTENT |
以潜在的质量降低,争取更多潜在客户。 |
HIGH_INTENT |
发掘更符合条件的潜在客户。 |
BookOnGoogleAsset
此类型没有任何字段。
“Google 上的图书”素材资源。用于重定向用户通过 Google 预订。“通过 Google 预订”会将重定向网址更改为直接通过 Google 预订。
PromotionAsset
促销信息素材资源。
JSON 表示法 |
---|
{ "promotionTarget": string, "discountModifier": enum ( |
字段 | |
---|---|
promotionTarget |
必需。对促销活动的定位对象的说明,自由形式。 |
discountModifier |
折扣资格限定词。 |
redemptionStartDate |
可兑换促销优惠的开始日期,格式为 yyyy-MM-dd。 |
redemptionEndDate |
可兑换促销优惠的最后日期,格式为 yyyy-MM-dd。 |
occasion |
宣传的时机。如果已设置时机,则兑换时间范围必须在与该时机关联的日期范围内。 |
languageCode |
促销活动的语言。以 BCP 47 语言标记表示。 |
startDate |
此资源生效且可开始投放的开始日期,格式为 yyyy-MM-dd。 |
endDate |
此素材资源有效且仍在投放的最后日期,格式为 yyyy-MM-dd。 |
adScheduleTargets[] |
一个不重叠的投放时间列表,用于指定素材资源可投放的所有时间间隔。每天最多可以设置 6 个时间表,总共 42 个。 |
联合字段 discount_type 。折扣类型,可以是折扣百分比或折扣金额。discount_type 只能是下列其中一项: |
|
percentOff |
促销活动中的折扣百分比。1,000,000 = 100%。必须提供此值或 moneyAmountOff。 |
moneyAmountOff |
促销活动中的折扣优惠金额。必须提供此项或 percentOff。 |
联合字段 promotion_trigger 。促销触发器。可以使用促销代码,或按符合条件的订单金额进行促销。promotion_trigger 只能是下列其中一项: |
|
promotionCode |
用户有资格享受促销时应使用的代码。 |
ordersOverAmount |
用户要想享受促销,订单总金额必须达到这一金额。 |
CalloutAsset
宣传信息素材资源。
JSON 表示法 |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
字段 | |
---|---|
calloutText |
必需。宣传信息文字。此字符串的长度应介于 1 和 25 之间(包括 1 和 25)。 |
startDate |
此资源生效且可开始投放的开始日期,格式为 yyyy-MM-dd。 |
endDate |
此素材资源有效且仍在投放的最后日期,格式为 yyyy-MM-dd。 |
adScheduleTargets[] |
一个不重叠的投放时间列表,用于指定素材资源可投放的所有时间间隔。每天最多可以设置 6 个时间表,总共 42 个。 |
StructuredSnippetAsset
结构化摘要素材资源。
JSON 表示法 |
---|
{ "header": string, "values": [ string ] } |
字段 | |
---|---|
header |
必需。摘要的标题。该字符串应为 https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers 中的预定义值之一 |
values[] |
必需。代码段中的值。此集合的大小应介于 3 到 10 之间(含 3 和 10)。每个值的长度应介于 1 到 25 个字符(含)之间。 |
SitelinkAsset
站内链接素材资源。
JSON 表示法 |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
字段 | |
---|---|
linkText |
必需。站内链接的网址显示文字。此字符串的长度应介于 1 和 25 之间(包括 1 和 25)。 |
description1 |
站内链接的说明的第一行。如此行已设置,则长度应介于 1 到 35 之间(包括 1 和 35),并且还必须设置 description2。 |
description2 |
附加链接说明的第二行。如此行已设置,则长度应介于 1 到 35 之间(包括 1 和 35),并且还必须设置 description1。 |
startDate |
此资源生效且可开始投放的开始日期,格式为 yyyy-MM-dd。 |
endDate |
此素材资源有效且仍在投放的最后日期,格式为 yyyy-MM-dd。 |
adScheduleTargets[] |
一个不重叠的投放时间列表,用于指定素材资源可投放的所有时间间隔。每天最多可以设置 6 个时间表,总共 42 个。 |
PageFeedAsset
页面 Feed 素材资源。
JSON 表示法 |
---|
{ "pageUrl": string, "labels": [ string ] } |
字段 | |
---|---|
pageUrl |
必需。广告客户想要定位的网页。 |
labels[] |
用于对网页网址进行分组的标签。 |
DynamicEducationAsset
动态教育素材资源。
JSON 表示法 |
---|
{ "programId": string, "locationId": string, "programName": string, "subject": string, "programDescription": string, "schoolName": string, "address": string, "contextualKeywords": [ string ], "androidAppLink": string, "similarProgramIds": [ string ], "iosAppLink": string, "iosAppStoreId": string, "thumbnailImageUrl": string, "imageUrl": string } |
字段 | |
---|---|
programId |
必需。计划 ID,可以是任何字母和数字序列,必须是唯一的,并且与再营销标记的值匹配。必填。 |
locationId |
地理位置 ID,可以是任意字母和数字序列,且必须是唯一的。 |
programName |
必需。课程名称,例如“护理”。必填。 |
subject |
研究主题,例如:健康。 |
programDescription |
计划说明,例如护理认证。 |
schoolName |
学校名称,例如北京朝阳护理学校。 |
address |
学校地址,可以采用以下某种格式指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区,例如 Mountain View, CA, USA。(2) 完整地址,例如:123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度,例如:41.40338, 2.17403 |
contextualKeywords[] |
内容相关关键字,例如“护理认证”、“健康”、“山景城”。 |
androidAppLink |
Android 深层链接,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
similarProgramIds[] |
类似计划 ID。 |
iosAppLink |
iOS 深层链接,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用,然后再通过深层链接将用户转到着陆页。如果设置了此字段,还必须提供 iosAppLink 字段。 |
thumbnailImageUrl |
缩略图网址,例如 http://www.example.com/thumbnail.png。缩略图图片不会作为图片素材资源上传。 |
imageUrl |
图片网址,例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。 |
MobileAppAsset
代表移动应用的素材资源。
JSON 表示法 |
---|
{
"appId": string,
"appStore": enum ( |
字段 | |
---|---|
appId |
必需。一个唯一标识移动应用的字符串。它应该只包含平台原生 ID,例如“com.android.ebay”(对于 Android)或“12345689”(对于 iOS)。 |
appStore |
必需。分发此特定应用的应用商店。 |
linkText |
必需。在广告中呈现链接时显示的可见文字。此字符串的长度应介于 1 和 25 之间(包括 1 和 25)。 |
startDate |
此资源生效且可开始投放的开始日期,格式为 yyyy-MM-dd。 |
endDate |
此素材资源有效且仍在投放的最后日期,格式为 yyyy-MM-dd。 |
HotelCalloutAsset
表示酒店宣传信息的素材资源。
JSON 表示法 |
---|
{ "text": string, "languageCode": string } |
字段 | |
---|---|
text |
必需。酒店宣传信息素材资源的文字。此字符串的长度应介于 1 和 25 之间(包括 1 和 25)。 |
languageCode |
必需。酒店宣传信息的语言。以 BCP 47 语言标记表示。 |
CallAsset
电话素材资源。
JSON 表示法 |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
字段 | |
---|---|
countryCode |
必需。电话号码的国家/地区代码(由两个字母组成)。示例:“US”“us”。 |
phoneNumber |
必需。广告客户的原始电话号码。示例:“1234567890”“(123)456-7890” |
callConversionReportingState |
指明此 CallAsset 应使用自己的来电转化设置、遵循帐号级设置,还是停用来电转化。 |
callConversionAction |
来电转化要归因于的转化操作。如果未设置,则使用默认转化操作。仅当 callConversionReportingState 设置为 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 时,此字段才有效。 |
adScheduleTargets[] |
一个不重叠的投放时间列表,用于指定素材资源可投放的所有时间间隔。每天最多可以设置 6 个时间表,总共 42 个。 |
PriceAsset
表示一系列价格优惠的素材资源。
JSON 表示法 |
---|
{ "type": enum ( |
字段 | |
---|---|
type |
必需。价格素材资源的类型。 |
priceQualifier |
价格素材资源的价格限定词。 |
languageCode |
必需。价格素材资源的语言。以 BCP 47 语言标记表示。 |
priceOfferings[] |
价格素材资源的价格。此集合的大小应介于 3 和 8 之间(含 3 和 8)。 |
PriceOffering
PriceAsset 中的一项价格服务。
JSON 表示法 |
---|
{ "header": string, "description": string, "price": { object ( |
字段 | |
---|---|
header |
必需。价格信息的标题。此字符串的长度应介于 1 和 25 之间(包括 1 和 25)。 |
description |
必需。对价格的说明。此字符串的长度应介于 1 和 25 之间(包括 1 和 25)。 |
price |
必需。提供的价格值。 |
unit |
报价的价格单位。 |
finalUrl |
必需。包含所有跨网域重定向后的最终到达网址。 |
finalMobileUrl |
包含所有跨网域重定向后的最终到达移动网址。 |
CallToActionAsset
号召性用语素材资源。
JSON 表示法 |
---|
{
"callToAction": enum ( |
字段 | |
---|---|
callToAction |
号召性用语。 |
DynamicRealEstateAsset
动态房地产素材资源。
JSON 表示法 |
---|
{ "listingId": string, "listingName": string, "cityName": string, "description": string, "address": string, "price": string, "imageUrl": string, "propertyType": string, "listingType": string, "contextualKeywords": [ string ], "formattedPrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarListingIds": [ string ] } |
字段 | |
---|---|
listingId |
必需。房源 ID,可以是字母和数字的任意序列,必须是唯一的,并且与再营销标记的值匹配。必填。 |
listingName |
必需。房源名称,例如 Boulevard Bungalow。必填。 |
cityName |
城市名称,例如“北京朝阳区”。 |
description |
例如,3 床 2 卫,1568 平方英尺 |
address |
地址,可以采用以下格式之一进行指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区,例如 Mountain View, CA, USA。(2) 完整地址,例如:123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度,例如:41.40338, 2.17403 |
price |
价格,可以是数字后跟字母货币代码,遵循 ISO 4217 标准。使用“.”作为小数点,例如 200,000.00 USD。 |
imageUrl |
图片网址,例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。 |
propertyType |
房源类型,例如房屋。 |
listingType |
房源类型,例如“出售”。 |
contextualKeywords[] |
内容相关关键字,例如“出售”;待售房屋。 |
formattedPrice |
统一格式的价格,可以是任意字符。如果设置,系统将使用此属性来替代 'price' [价格],例如,起价为 $200,000.00。 |
androidAppLink |
Android 深层链接,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深层链接,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用,然后再通过深层链接将用户转到着陆页。如果设置了此字段,还必须提供 iosAppLink 字段。 |
similarListingIds[] |
类似房源 ID。 |
DynamicCustomAsset
动态自定义素材资源。
JSON 表示法 |
---|
{ "id": string, "id2": string, "itemTitle": string, "itemSubtitle": string, "itemDescription": string, "itemAddress": string, "itemCategory": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "imageUrl": string, "contextualKeywords": [ string ], "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarIds": [ string ] } |
字段 | |
---|---|
id |
必需。ID 可以是字母和数字的任意序列,必须是唯一的,并且与再营销代码的值(例如 sedan)相匹配。必填。 |
id2 |
ID2,可以是字母和数字的任意序列,例如红色。ID 序列 (ID + ID2) 必须是唯一的。 |
itemTitle |
必需。商品标题,例如中型轿车。必填。 |
itemSubtitle |
商品副标题,例如“在山景城经销商处”。 |
itemDescription |
商品描述,例如畅销中型汽车。 |
itemAddress |
可以采用以下某种格式指定的商品地址。(1) 城市、州/省/自治区/直辖市、代码、国家/地区,例如 Mountain View, CA, USA。(2) 完整地址,例如:123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度,例如:41.40338, 2.17403 |
itemCategory |
商品类别,例如轿车。 |
price |
价格,可以是数字后跟字母货币代码,遵循 ISO 4217 标准。使用“.”作为小数点,例如 20,000.00 USD。 |
salePrice |
促销价,可以是数字后跟字母货币代码,符合 ISO 4217 标准。使用“.”作为小数点,例如 15,000.00 USD。该价格必须小于“price”字段。 |
formattedPrice |
统一格式的价格,可以是任意字符。如果设置,系统将使用此属性来替代 'price' [价格],例如,起价为 $20,000.00。 |
formattedSalePrice |
统一格式的促销价,可以是任意字符。如果设置了此属性,系统将使用此属性而非“sale price”[促销价] 来实现“促销价”属性,例如“促销价为 15,000.00 美元”。 |
imageUrl |
图片网址,例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。 |
contextualKeywords[] |
内容相关关键字,例如轿车、四门轿车。 |
androidAppLink |
Android 深层链接,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深层链接,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用,然后再通过深层链接将用户转到着陆页。如果设置了此字段,还必须提供 iosAppLink 字段。 |
similarIds[] |
类似 ID。 |
DynamicHotelsAndRentalsAsset
动态酒店及房屋租赁素材资源。
JSON 表示法 |
---|
{ "propertyId": string, "propertyName": string, "imageUrl": string, "destinationName": string, "description": string, "price": string, "salePrice": string, "starRating": string, "category": string, "contextualKeywords": [ string ], "address": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "formattedPrice": string, "formattedSalePrice": string, "similarPropertyIds": [ string ] } |
字段 | |
---|---|
propertyId |
必需。媒体资源 ID,可以是字母和数字的任意序列,必须是唯一的,并且与再营销代码的值匹配。必填。 |
propertyName |
必需。房源名称,例如 Mountain View Hotel。必填。 |
imageUrl |
图片网址,例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。 |
destinationName |
目的地名称,例如“Downtown Mountain View”。 |
description |
说明,例如“靠近 SJC 机场”。 |
price |
价格,可以是数字后跟字母货币代码,遵循 ISO 4217 标准。使用“.”作为小数点,例如 100.00 USD。 |
salePrice |
ISO 4217 标准。使用“.”作为小数点,例如 80.00 USD。该价格必须小于“price”字段。 |
starRating |
星级。必须是 1 到 5 之间的数字(含 1 和 5)。 |
category |
类别,例如“酒店套房”。 |
contextualKeywords[] |
内容相关关键字,例如山景城“酒店”,南湾酒店。 |
address |
地址,可以采用以下格式之一进行指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区,例如 Mountain View, CA, USA。(2) 完整地址,例如:123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度,例如:41.40338, 2.17403 |
androidAppLink |
Android 深层链接,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深层链接,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用,然后再通过深层链接将用户转到着陆页。如果设置了此字段,还必须提供 iosAppLink 字段。 |
formattedPrice |
统一格式的价格,可以是任意字符。如果设置此属性,则使用此属性来替代“price”。例如,“$100.00 起”。 |
formattedSalePrice |
统一格式的促销价,可以是任意字符。如果设置,系统将使用此属性而非 '促销价' [sale price] 属性,例如“促销价为 80.00 美元”。 |
similarPropertyIds[] |
类似房源 ID。 |
DynamicFlightsAsset
动态航班素材资源。
JSON 表示法 |
---|
{ "destinationId": string, "originId": string, "flightDescription": string, "imageUrl": string, "destinationName": string, "originName": string, "flightPrice": string, "flightSalePrice": string, "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarDestinationIds": [ string ], "customMapping": string } |
字段 | |
---|---|
destinationId |
必需。目标页面 ID,可以是字母和数字的任意序列,必须是唯一的,并且与再营销代码的值匹配。必填。 |
originId |
出发地 ID,可以是字母和数字的任意序列。ID 序列(目的地 ID + 出发地 ID)必须是唯一的。 |
flightDescription |
必需。航班说明,例如“预订机票”。必填。 |
imageUrl |
图片网址,例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。 |
destinationName |
目的地名称,例如巴黎。 |
originName |
出发地名称,例如伦敦。 |
flightPrice |
航班价格,可以是数字后跟字母货币代码,遵循 ISO 4217 标准。使用“.”作为小数点,例如 100.00 USD。 |
flightSalePrice |
航班促销价,可以是数字后跟字母货币代码,符合 ISO 4217 标准。使用“.”作为小数点,例如 80.00 USD。必须小于“flightPrice”字段。 |
formattedPrice |
统一格式的价格,可以是任意字符。如果设置此属性,则使用此属性来替代“price”。例如,“$100.00 起”。 |
formattedSalePrice |
统一格式的促销价,可以是任意字符。如果设置,系统将使用此属性而非 '促销价' [sale price] 属性,例如“促销价为 80.00 美元”。 |
androidAppLink |
Android 深层链接,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深层链接,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用,然后再通过深层链接将用户转到着陆页。如果设置了此字段,还必须提供 iosAppLink 字段。 |
similarDestinationIds[] |
类似的目的地 ID,例如:PAR、LON。 |
customMapping |
自定义字段可以是以分隔符(“ |
DiscoveryCarouselCardAsset
一项轮播式发现广告卡片素材资源。
JSON 表示法 |
---|
{ "marketingImageAsset": string, "squareMarketingImageAsset": string, "portraitMarketingImageAsset": string, "headline": string, "callToActionText": string } |
字段 | |
---|---|
marketingImageAsset |
相关 1.91:1 营销图片的素材资源资源名称。必须提供此和/或方形营销图片素材资源。 |
squareMarketingImageAsset |
相关方形营销图片的素材资源资源名称。此素材资源和/或营销图片素材资源为必填项。 |
portraitMarketingImageAsset |
关联的 4:5 纵向营销图片的素材资源资源名称。 |
headline |
必需。轮播卡片的标题。 |
callToActionText |
号召性用语文字。 |
DynamicTravelAsset
动态旅游素材资源。
JSON 表示法 |
---|
{ "destinationId": string, "originId": string, "title": string, "destinationName": string, "destinationAddress": string, "originName": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "category": string, "contextualKeywords": [ string ], "similarDestinationIds": [ string ], "imageUrl": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string } |
字段 | |
---|---|
destinationId |
必需。目标页面 ID,可以是字母和数字的任意序列,必须是唯一的,并且与再营销代码的值匹配。必填。 |
originId |
出发地 ID,可以是字母和数字的任意序列。ID 序列(目的地 ID + 出发地 ID)必须是唯一的。 |
title |
必需。标题,例如“预订火车票”。必填。 |
destinationName |
目的地名称,例如巴黎。 |
destinationAddress |
目的地地址,可以采用以下格式之一进行指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区,例如 Mountain View, CA, USA。(2) 完整地址,例如:123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度,例如 41.40338, 2.17403。 |
originName |
出发地名称,例如伦敦。 |
price |
价格,可以是数字后跟字母货币代码,遵循 ISO 4217 标准。使用“.”作为小数点,例如 100.00 USD。 |
salePrice |
促销价,可以是数字后跟字母货币代码,遵循 ISO 4217 标准。使用“.”作为小数点,例如 80.00 USD。该价格必须小于“price”字段。 |
formattedPrice |
统一格式的价格,可以是任意字符。如果设置此属性,则使用此属性来替代“price”。例如,“$100.00 起”。 |
formattedSalePrice |
统一格式的促销价,可以是任意字符。如果设置,系统将使用此属性而非 '促销价' [sale price] 属性,例如“促销价为 80.00 美元”。 |
category |
类别,例如“极速”。 |
contextualKeywords[] |
内容相关关键字,例如“巴黎火车”。 |
similarDestinationIds[] |
类似的目的地 ID,例如纽约市。 |
imageUrl |
图片网址,例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。 |
androidAppLink |
Android 深层链接,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深层链接,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用,然后再通过深层链接将用户转到着陆页。如果设置了此字段,还必须提供 iosAppLink 字段。 |
DynamicLocalAsset
动态本地素材资源。
JSON 表示法 |
---|
{ "dealId": string, "dealName": string, "subtitle": string, "description": string, "price": string, "salePrice": string, "imageUrl": string, "address": string, "category": string, "contextualKeywords": [ string ], "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "similarDealIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
字段 | |
---|---|
dealId |
必需。交易 ID,可以是字母和数字的任意序列,必须是唯一的,并且与再营销代码的值匹配。必填。 |
dealName |
必需。优惠名称,例如,山景城杂货店五折优惠。必填。 |
subtitle |
副标题,例如“杂货”。 |
description |
例如“每周账单节省”。 |
price |
价格,可以是数字后跟字母货币代码,遵循 ISO 4217 标准。使用“.”作为小数点,例如 100.00 USD。 |
salePrice |
促销价,可以是数字后跟字母货币代码,符合 ISO 4217 标准。使用“.”作为小数点,例如 80.00 USD。该价格必须小于“price”字段。 |
imageUrl |
图片网址,例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。 |
address |
地址,可以采用以下格式之一进行指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区,例如 Mountain View, CA, USA。(2) 完整地址,例如:123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度,例如 41.40338, 2.17403。 |
category |
类别,例如食品。 |
contextualKeywords[] |
内容相关关键字,例如“保存杂货优惠券”。 |
formattedPrice |
统一格式的价格,可以是任意字符。如果设置此属性,则使用此属性来替代“price”。例如,“$100.00 起”。 |
formattedSalePrice |
统一格式的促销价,可以是任意字符。如果设置,系统将使用此属性而非 '促销价' [sale price] 属性,例如“促销价为 80.00 美元”。 |
androidAppLink |
Android 深层链接,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
similarDealIds[] |
类似交易 ID,例如 1275。 |
iosAppLink |
iOS 深层链接,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用,然后再通过深层链接将用户转到着陆页。如果设置了此字段,还必须提供 iosAppLink 字段。 |
DynamicJobsAsset
动态招聘信息素材资源。
JSON 表示法 |
---|
{ "jobId": string, "locationId": string, "jobTitle": string, "jobSubtitle": string, "description": string, "imageUrl": string, "jobCategory": string, "contextualKeywords": [ string ], "address": string, "salary": string, "androidAppLink": string, "similarJobIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
字段 | |
---|---|
jobId |
必需。职位 ID,可以是字母和数字的任意序列,必须是唯一的,并且与再营销代码的值匹配。必填。 |
locationId |
地理位置 ID,可以是任意字母和数字序列。ID 序列(作业 ID + 地理位置 ID)必须是唯一的。 |
jobTitle |
必需。职位,例如软件工程师。必填。 |
jobSubtitle |
职位副标题,例如 II 级。 |
description |
例如“运用您的技术技能”。 |
imageUrl |
图片网址,例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。 |
jobCategory |
职位类别,例如“技术”。 |
contextualKeywords[] |
内容相关关键字,例如“软件工程职位”。 |
address |
地址,可以采用以下格式之一进行指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区,例如 Mountain View, CA, USA。(2) 完整地址,例如:123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度,例如 41.40338, 2.17403。 |
salary |
薪资,例如 $100,000。 |
androidAppLink |
Android 深层链接,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
similarJobIds[] |
类似的职位 ID,例如 1275。 |
iosAppLink |
iOS 深层链接,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用,然后再通过深层链接将用户转到着陆页。如果设置了此字段,还必须提供 iosAppLink 字段。 |
LocationAsset
地址素材资源。
JSON 表示法 |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
字段 | |
---|---|
placeId |
地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。对于给定的客户 ID 和资产类型,此字段是唯一的。如需详细了解地点 ID,请参阅 https://developers.google.com/places/web-service/place-id。 |
businessProfileLocations[] |
客户的营业地点列表。只有在从商家资料账号同步地址素材资源时,系统才会返回此值。同一个帐号下可以有多条指向同一地点 ID 的商家资料商家信息。 |
locationOwnershipType |
营业地点所有权的类型。如果类型为 BUSINESS_OWNER,它将作为附加地址信息提供。如果类型为 AFFILIATE,它将作为关联商户地址提供。 |
BusinessProfileLocation
从关联的商家资料账号同步的商家资料营业地点数据。
JSON 表示法 |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
字段 | |
---|---|
labels[] |
广告客户在商家资料账号中为营业地点指定的标签。这是从商家资料账号同步过来的。 |
storeCode |
此营业地点的商家资料商店代码。这是从商家资料账号同步过来的。 |
listingId |
此商家资料营业地点的商家信息 ID。这是从关联的商家资料账号同步过来的。 |
HotelPropertyAsset
酒店房源素材资源。
JSON 表示法 |
---|
{ "placeId": string, "hotelAddress": string, "hotelName": string } |
字段 | |
---|---|
placeId |
地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。如需了解详情,请访问 https://developers.google.com/places/web-service/place-id。 |
hotelAddress |
酒店的地址。只读。 |
hotelName |
酒店的名称。只读。 |