- JSON 表示法
- AssetType
- AssetPolicySummary
- AssetFieldTypePolicySummary
- YoutubeVideoAsset
- MediaBundleAsset
- ImageAsset
- ImageDimension
- TextAsset
- LeadFormAsset
- LeadFormCallToActionType
- LeadFormFieldLeadFormField
- LeadFormSingleChoiceAnswers
- LeadFormCustomQuestionField
- LeadFormDeliveryMethod
- WebhookDelivery
- LeadFormPostSubmitCallToActionType
- LeadFormDesiredIntent
- BookOnGoogleAsset
- PromotionAsset
- CalloutAsset
- StructuredSnippetAsset
- SitelinkAsset
- PageFeedAsset
- DynamicEducationAsset
- MobileAppAsset
- HotelCalloutAsset
- CallAsset
- PriceAsset
- PriceOffering
- CallToActionAsset
- DynamicRealEstateAsset
- DynamicCustomAsset
- DynamicHotelsAndRentalsAsset
- DynamicFlightsAsset
- DemandGenCarouselCardAsset
- 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 |
动态航班素材资源。 |
demandGenCarouselCardAsset |
不可变。需求开发广告的轮播卡片素材资源。 |
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 。定义此表单字段接受的答案配置。如果未设置 oneof,则为自由文本答案。answers 只能是下列其中一项: |
|
singleChoiceAnswers |
单选题的答案配置。只能为预先审查的问题字段进行设置。最少需提供 2 个回答,最多允许 12 个。 |
hasLocationAnswer |
位置问题的答案配置。如果为 true,广告系列/账号一级的位置数据(省/自治区/直辖市、城市、商家名称等)将显示在潜在客户表单中。从 V13.1 开始,对于在广告系列/帐号级别设置了地址素材资源的广告客户,只能针对“您的首选经销商是什么?”问题设置 hasLocationAnswer。 |
LeadFormSingleChoiceAnswers
定义单选题的可能答案,通常以单选下拉列表的形式显示。
JSON 表示法 |
---|
{ "answers": [ string ] } |
字段 | |
---|---|
answers[] |
单个问题字段的选项列表。条目顺序定义了界面顺序。最少需提供 2 个回答,最多允许 12 个。 |
LeadFormCustomQuestionField
表单中的一个自定义问题输入字段实例。
JSON 表示法 |
---|
{ "customQuestionText": string, // Union field |
字段 | |
---|---|
customQuestionText |
确切的自定义问题字段文本(例如“您的车辆属于哪种类型?”)。 |
联合字段 answers 。定义此表单字段接受的答案配置。如果未设置 oneof,则为自由文本答案。answers 只能是下列其中一项: |
|
singleChoiceAnswers |
单选题的答案配置。最少 2 个,最多允许 12 个。 |
hasLocationAnswer |
位置问题的答案配置。如果为 true,广告系列/账号一级的位置数据(省/自治区/直辖市、城市、商家名称等)将显示在潜在客户表单中。从 V13.1 开始,对于在广告系列/帐号级别设置了地址素材资源的广告客户,只能针对“您的首选经销商是什么?”问题设置 hasLocationAnswer。 |
LeadFormDeliveryMethod
有关潜在客户如何投放给广告客户的配置。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 delivery_details 。传送的各种子类型。delivery_details 只能是下列其中一项: |
|
webhook |
网络钩子传送方法。 |
WebhookDelivery
Google 会向广告客户指定的端点发出 HTTP 调用,从而将潜在客户信息告知他们。这些请求包含的 JSON 与 Google 作为表单广告文档的一部分发布的架构相匹配。
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 个字符之间(含 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) 城市、州/省/自治区/直辖市、代码、国家/地区,例如美国加利福尼亚州山景城。(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,如 Android 的“com.android.ebay”或 iOS 的“12345689”。 |
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) 城市、州/省/自治区/直辖市、代码、国家/地区,例如美国加利福尼亚州山景城。(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,可以是任意字母和数字序列,且必须是唯一的,并且与再营销代码的值(例如“轿车”)相匹配。必填。 |
id2 |
ID2,可以是任意字母和数字序列,例如红色。ID 序列 (ID + ID2) 必须是唯一的。 |
itemTitle |
必需。商品标题,例如中型轿车。必填。 |
itemSubtitle |
商品副标题,例如“在山景城经销商处。 |
itemDescription |
商品说明,例如畅销的中型汽车。 |
itemAddress |
商品地址,可采用以下某种格式指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区,例如美国加利福尼亚州山景城。(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 |
必需。房源名称(例如“朝阳酒店”)。必填。 |
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) 城市、州/省/自治区/直辖市、代码、国家/地区,例如美国加利福尼亚州山景城。(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 |
一个自定义字段,可以是映射至分隔符(“,”“|”和“:”)的多个键到值,格式为“ |
DemandGenCarouselCardAsset
需求开发轮播卡片素材资源。
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) 城市、州/省/自治区/直辖市、代码、国家/地区,例如美国加利福尼亚州山景城。(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) 城市、州/省/自治区/直辖市、代码、国家/地区,例如美国加利福尼亚州山景城。(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) 城市、州/省/自治区/直辖市、代码、国家/地区,例如美国加利福尼亚州山景城。(2) 完整地址,例如:123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度,例如 41.40338、2.17403。 |
salary |
薪资(例如 10 万美元)。 |
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 |
酒店的名称。只读。 |