- JSON 表示法
- StructuredSnippetFeedItem
- AppFeedItem
- AppStore
- TextMessageFeedItem
- PriceFeedItem
- PriceOffer
- PromotionFeedItem
- LocationFeedItem
- AffiliateLocationFeedItem
- HotelCalloutFeedItem
- ImageFeedItem
附加信息 Feed 项。
JSON 表示法 |
---|
{ "resourceName": string, "extensionType": enum ( |
字段 | |
---|---|
resourceName |
不可变。附加信息 Feed 项的资源名称。附加信息 Feed 项资源名称采用以下形式:
|
extensionType |
仅供输出。附加信息 Feed 项的附加信息类型。此字段为只读字段。 |
adSchedules[] |
互不重叠的时间表列表,用于指定此 Feed 项可投放的所有时间间隔。每天最多可以设置 6 个时间表。 |
device |
目标设备。 |
targetedKeyword |
指定关键字。 |
status |
仅供输出。Feed 项的状态。此字段为只读字段。 |
id |
仅供输出。此 Feed 项的 ID。只读。 |
startDateTime |
此 Feed 项生效并可开始投放的开始时间。该时间采用客户所在的时区。其格式为“YYYY-MM-DD HH:MM:SS”。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
endDateTime |
此 Feed 项不再生效并将停止投放的结束时间。该时间采用客户所在的时区。其格式为“YYYY-MM-DD HH:MM:SS”。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
targetedGeoTargetConstant |
已定位的地理位置定位常量。 |
联合字段 extension 。附加信息类型。extension 只能是下列其中一项: |
|
sitelinkFeedItem |
站内链接。 |
structuredSnippetFeedItem |
附加结构化摘要信息。 |
appFeedItem |
附加应用信息。 |
callFeedItem |
附加电话信息。 |
calloutFeedItem |
附加宣传信息。 |
textMessageFeedItem |
附加短信信息。 |
priceFeedItem |
附加价格信息。 |
promotionFeedItem |
附加促销信息。 |
locationFeedItem |
仅供输出。附加地址信息。营业地点信息会从商家资料同步到 Feed。此字段为只读字段。 |
affiliateLocationFeedItem |
仅供输出。附加关联商户地址信息。Feed 地址信息是由 Google Ads 根据连锁店 ID 填充的。此字段为只读字段。 |
hotelCalloutFeedItem |
酒店附加宣传信息。 |
imageFeedItem |
不可变。广告客户提供的附加图片。 |
联合字段 serving_resource_targeting 。在广告系列或广告组一级进行定位。定位到某个广告系列或广告组的 Feed 项将仅随该资源一起投放。serving_resource_targeting 只能是下列其中一项: |
|
targetedCampaign |
目标广告系列。 |
targetedAdGroup |
定位的广告组。 |
StructuredSnippetFeedItem
表示附加结构化摘要信息。
JSON 表示法 |
---|
{ "values": [ string ], "header": string } |
字段 | |
---|---|
values[] |
代码段中的值。该集合的最大容量是 10。 |
header |
摘要的标题。此字符串不能为空。 |
AppFeedItem
表示附加应用信息。
JSON 表示法 |
---|
{ "appStore": enum ( |
字段 | |
---|---|
appStore |
目标应用所属的应用商店。必须填写此字段。 |
finalUrls[] |
经过所有跨网域重定向后可能出现的最终到达网址的列表。此列表不能为空。 |
finalMobileUrls[] |
包含所有跨网域重定向后可能的最终到达移动网址的列表。 |
urlCustomParameters[] |
映射列表,用于替换 trackingUrlTemplate、FinalUrls 和/或 finalMobileUrls 中的网址自定义参数代码。 |
linkText |
在广告中呈现链接时显示的可见文字。此字符串不能为空,且长度应介于 1 和 25 之间(含 1 和 25)。 |
appId |
目标应用的商店特定 ID。此字符串不能为空。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。默认值为“{lpurl}”。 |
finalUrlSuffix |
用于将参数附加到通过并行跟踪投放的着陆页网址的网址模板。 |
AppStore
附加应用信息中的应用商店类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
APPLE_ITUNES |
Apple iTunes。 |
GOOGLE_PLAY |
Google Play。 |
TextMessageFeedItem
用户只需点击一种可以向广告客户发送短信的扩展程序。
JSON 表示法 |
---|
{ "businessName": string, "countryCode": string, "phoneNumber": string, "text": string, "extensionText": string } |
字段 | |
---|---|
businessName |
要附加到消息文字之前的商家名称。必须填写此字段。 |
countryCode |
广告客户电话号码的两个大写字母国家/地区代码。必须填写此字段。 |
phoneNumber |
将向广告主的电话号码。必填。 |
text |
要在广告中显示的文字。必须填写此字段。 |
extensionText |
在即时通讯应用中填充的 message extensionText。 |
PriceFeedItem
表示附加价格信息。
JSON 表示法 |
---|
{ "type": enum ( |
字段 | |
---|---|
type |
此附加信息的附加价格信息类型。 |
priceQualifier |
此附加价格信息对应的所有商品的价格限定词。 |
priceOfferings[] |
此附加价格信息中的定价。 |
trackingUrlTemplate |
跟踪此附加价格信息的所有商品的跟踪网址模板。 |
languageCode |
此附加价格信息使用的语言代码。 |
finalUrlSuffix |
跟踪此附加价格信息的所有商品的跟踪网址模板。 |
PriceOffer
表示附加价格信息中的一项价格优惠。
JSON 表示法 |
---|
{ "price": { object ( |
字段 | |
---|---|
price |
此优惠的价格值。 |
unit |
此商品的价格单位。 |
finalUrls[] |
经过所有跨网域重定向后可能出现的最终到达网址的列表。 |
finalMobileUrls[] |
包含所有跨网域重定向后可能的最终到达移动网址的列表。 |
header |
此优惠的标题文字。 |
description |
此优惠的说明文字。 |
PromotionFeedItem
表示附加促销信息。
JSON 表示法 |
---|
{ "discountModifier": enum ( |
字段 | |
---|---|
discountModifier |
用于修改折扣资格的枚举。 |
occasion |
宣传的时机。如果已设置时机,则兑换时间范围必须在与该时机关联的日期范围内。 |
finalUrls[] |
经过所有跨网域重定向后可能出现的最终到达网址的列表。必须填写此字段。 |
finalMobileUrls[] |
包含所有跨网域重定向后可能的最终到达移动网址的列表。 |
urlCustomParameters[] |
映射列表,用于替换 trackingUrlTemplate、FinalUrls 和/或 finalMobileUrls 中的网址自定义参数代码。 |
promotionTarget |
对促销活动的定位对象的说明,自由形式。必须填写此字段。 |
promotionStartDate |
可兑换促销优惠的开始日期。 |
promotionEndDate |
可兑换促销优惠的最后日期。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。 |
finalUrlSuffix |
用于将参数附加到通过并行跟踪投放的着陆页网址的网址模板。 |
languageCode |
促销活动的语言。以 BCP 47 语言标记表示。 |
联合字段 discount_type 。折扣类型,可以是折扣百分比或折扣金额。discount_type 只能是下列其中一项: |
|
percentOff |
促销活动提供的折扣百分比(以微单位表示)。100 万等于百分之 1。必须提供此项或 money_off_amount。 |
moneyAmountOff |
促销活动中的折扣优惠金额。必须提供此项或 percentOff。 |
联合字段 promotion_trigger 。促销触发器。可以使用促销代码,或按符合条件的订单金额进行促销。promotion_trigger 只能是下列其中一项: |
|
promotionCode |
用户有资格享受促销时应使用的代码。 |
ordersOverAmount |
用户要想享受促销,订单总金额必须达到这一金额。 |
LocationFeedItem
表示附加地址信息。
JSON 表示法 |
---|
{ "businessName": string, "addressLine1": string, "addressLine2": string, "city": string, "province": string, "postalCode": string, "countryCode": string, "phoneNumber": string } |
字段 | |
---|---|
businessName |
商家的名称。 |
addressLine1 |
商家地址的第 1 行。 |
addressLine2 |
商家地址的第 2 行。 |
city |
商家地址所在的城市。 |
province |
商家地址所在的省/自治区/直辖市。 |
postalCode |
商家地址所属的邮政编码。 |
countryCode |
商家地址的国家/地区代码。 |
phoneNumber |
商户的电话号码。 |
AffiliateLocationFeedItem
表示附加关联商户地址信息。
JSON 表示法 |
---|
{ "businessName": string, "addressLine1": string, "addressLine2": string, "city": string, "province": string, "postalCode": string, "countryCode": string, "phoneNumber": string, "chainId": string, "chainName": string } |
字段 | |
---|---|
businessName |
商家的名称。 |
addressLine1 |
商家地址的第 1 行。 |
addressLine2 |
商家地址的第 2 行。 |
city |
商家地址所在的城市。 |
province |
商家地址所在的省/自治区/直辖市。 |
postalCode |
商家地址所属的邮政编码。 |
countryCode |
商家地址的国家/地区代码。 |
phoneNumber |
商户的电话号码。 |
chainId |
以商品卖家身份宣传的零售连锁店的 ID。 |
chainName |
连锁店名称。 |
HotelCalloutFeedItem
表示酒店附加宣传信息。
JSON 表示法 |
---|
{ "text": string, "languageCode": string } |
字段 | |
---|---|
text |
宣传信息文字。此字符串的长度应介于 1 和 25 之间(包括 1 和 25)。 |
languageCode |
酒店宣传信息文字的语言。符合 IETF BCP 47 语言代码。 |
ImageFeedItem
表示广告客户提供的附加图片。
JSON 表示法 |
---|
{ "imageAsset": string } |
字段 | |
---|---|
imageAsset |
必需。图片素材资源的资源名称。 |