- JSON 表示法
- AttributeFieldMapping
- SitelinkPlaceholderField
- CallPlaceholderField
- AppPlaceholderField
- LocationPlaceholderField
- AffiliateLocationPlaceholderField
- CalloutPlaceholderField
- StructuredSnippetPlaceholderField
- MessagePlaceholderField
- PricePlaceholderField
- PromotionPlaceholderField
- AdCustomizerPlaceholderField
- DsaPageFeedCriterionField
- LocationExtensionTargetingCriterionField
- EducationPlaceholderField
- FlightPlaceholderField
- CustomPlaceholderField
- HotelPlaceholderField
- RealEstatePlaceholderField
- TravelPlaceholderField
- LocalPlaceholderField
- JobPlaceholderField
- ImagePlaceholderField
- FeedMappingStatus
- FeedMappingCriterionType
Feed 映射。
JSON 表示法 |
---|
{ "resourceName": string, "attributeFieldMappings": [ { object ( |
字段 | |
---|---|
resourceName |
不可变。Feed 映射的资源名称。Feed 映射资源名称采用以下格式:
|
attributeFieldMappings[] |
不可变。Feed 属性到字段的映射。这些映射属于一对多关系,这意味着 1 个 Feed 属性可用于填充多个占位符字段,但 1 个占位符字段只能从 1 个 Feed 属性中提取数据。广告定制工具除外,1 个占位符字段可映射到多个 Feed 属性。必填。 |
status |
仅供输出。Feed 映射的状态。此字段为只读字段。 |
feed |
不可变。此 Feed 映射的 Feed。 |
联合字段 target 。Feed 映射目标。可以是占位符或条件。对于给定的 Feed,有效的 FeedMapping 必须具有唯一的定位条件。必需。target 只能是下列其中一项: |
|
placeholderType |
不可变。此映射的占位符类型(例如,如果映射将 Feed 属性映射到占位符字段)。 |
criterionType |
不可变。此映射的条件类型(例如,如果映射将 Feed 属性映射到条件字段)。 |
AttributeFieldMapping
从 Feed 属性 ID 到占位符或条件字段 ID 的映射。
JSON 表示法 |
---|
{ "feedAttributeId": string, "fieldId": string, // Union field |
字段 | |
---|---|
feedAttributeId |
不可变。作为映射来源的 Feed 属性。 |
fieldId |
仅供输出。占位符字段 ID。如果占位符字段枚举未在当前 API 版本中发布,系统将填充此字段,且字段 oneof 将为空。此字段为只读字段。 |
联合字段 field 。使用上述 Feed 属性中的数据填充的占位符或条件字段。必需。field 只能是下列其中一项: |
|
sitelinkField |
不可变。站内链接占位符字段。 |
callField |
不可变。调用占位符字段。 |
appField |
不可变。应用占位符字段。 |
locationField |
仅供输出。位置占位符字段。此字段为只读字段。 |
affiliateLocationField |
仅供输出。关联商户地址占位符字段。此字段为只读字段。 |
calloutField |
不可变。宣传信息占位符字段。 |
structuredSnippetField |
不可变。结构化摘要占位符字段。 |
messageField |
不可变。消息占位符字段。 |
priceField |
不可变。价格占位符字段。 |
promotionField |
不可变。促销信息占位符字段。 |
adCustomizerField |
不可变。广告定制工具占位符字段 |
dsaPageFeedField |
不可变。动态搜索广告页面 Feed 字段。 |
locationExtensionTargetingField |
不可变。地理位置定位目标字段。 |
educationField |
不可变。教育占位符字段 |
flightField |
不可变。广告投放占位符字段 |
customField |
不可变。自定义占位符字段 |
hotelField |
不可变。酒店占位符字段 |
realEstateField |
不可变。房地产占位符字段 |
travelField |
不可变。旅行占位符字段 |
localField |
不可变。本地占位符字段 |
jobField |
不可变。作业占位符字段 |
imageField |
不可变。图片占位符字段 |
SitelinkPlaceholderField
站内链接占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
TEXT |
数据类型:STRING。附加链接的链接文字。 |
LINE_1 |
数据类型:STRING。附加链接说明的第一行。 |
LINE_2 |
数据类型:STRING。附加链接说明的第二行。 |
FINAL_URLS |
数据类型:网址_LIST。使用升级版网址时的附加链接最终到达网址。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。附加链接在使用升级版网址时的最终到达移动网址。 |
TRACKING_URL |
数据类型:网址。使用升级版网址时的附加链接跟踪模板。 |
FINAL_URL_SUFFIX |
数据类型:STRING。使用并行跟踪时的附加链接的最终到达网址后缀。 |
CallPlaceholderField
“来电”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PHONE_NUMBER |
数据类型:STRING。要附加到广告中的广告客户电话号码。 |
COUNTRY_CODE |
数据类型:STRING。广告客户电话号码的两个大写字母国家/地区代码。 |
TRACKED |
数据类型:BOOLEAN。指明是否已启用通话跟踪。默认值:true。 |
CONVERSION_TYPE_ID |
数据类型:INT64。AdCallMetricsConversion 对象的 ID。此对象包含 phoneCallDurationfield,该字段是通话要被视为转化的最短时长(以秒为单位)。 |
CONVERSION_REPORTING_STATE |
数据类型:STRING。指明此附加电话信息是使用自己的来电转化设置,还是遵循帐号级设置。有效值为:USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 和 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION。 |
AppPlaceholderField
应用占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
STORE |
数据类型:INT64。目标应用所属的应用商店。有效值包括:1 = Apple iTunes Store;2 = Google Play 商店。 |
ID |
数据类型:STRING。目标应用的商店特定 ID。 |
LINK_TEXT |
数据类型:STRING。在广告中呈现链接时显示的可见文字。 |
URL |
数据类型:STRING。应用内链接的目标网址。 |
FINAL_URLS |
数据类型:网址_LIST。使用升级版网址时的应用内链接的最终到达网址。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。使用升级版网址时的应用内链接的最终到达移动网址。 |
TRACKING_URL |
数据类型:网址。使用升级版网址时的应用内链接跟踪模板。 |
FINAL_URL_SUFFIX |
数据类型:STRING。使用并行跟踪时应用内链接的最终到达网址后缀。 |
LocationPlaceholderField
“Location”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
BUSINESS_NAME |
数据类型:STRING。商家的名称。 |
ADDRESS_LINE_1 |
数据类型:STRING。商家地址的第 1 行。 |
ADDRESS_LINE_2 |
数据类型:STRING。商家地址的第 2 行。 |
CITY |
数据类型:STRING。商家地址所在的城市。 |
PROVINCE |
数据类型:STRING。商家地址所在的省/自治区/直辖市。 |
POSTAL_CODE |
数据类型:STRING。商家地址所属的邮政编码。 |
COUNTRY_CODE |
数据类型:STRING。商家地址的国家/地区代码。 |
PHONE_NUMBER |
数据类型:STRING。商户的电话号码。 |
AffiliateLocationPlaceholderField
“关联商户地址”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
BUSINESS_NAME |
数据类型:STRING。商家的名称。 |
ADDRESS_LINE_1 |
数据类型:STRING。商家地址的第 1 行。 |
ADDRESS_LINE_2 |
数据类型:STRING。商家地址的第 2 行。 |
CITY |
数据类型:STRING。商家地址所在的城市。 |
PROVINCE |
数据类型:STRING。商家地址所在的省/自治区/直辖市。 |
POSTAL_CODE |
数据类型:STRING。商家地址所属的邮政编码。 |
COUNTRY_CODE |
数据类型:STRING。商家地址的国家/地区代码。 |
PHONE_NUMBER |
数据类型:STRING。商户的电话号码。 |
LANGUAGE_CODE |
数据类型:STRING。商家的语言代码。 |
CHAIN_ID |
数据类型:INT64。连锁店的 ID。 |
CHAIN_NAME |
数据类型:STRING。连锁店名称。 |
CalloutPlaceholderField
宣传信息占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
CALLOUT_TEXT |
数据类型:STRING。宣传信息文字。 |
StructuredSnippetPlaceholderField
结构化摘要占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
HEADER |
数据类型:STRING。产品/服务摘要的类别。必须与预定义的结构化摘要标题之一完全匹配。如需查看列表,请访问 https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers |
SNIPPETS |
数据类型:STRING_LIST。描述您的产品/服务的文本值。所有文字都必须健康无害。不允许使用特殊字符或非 ASCII 字符。一个摘要最多可以包含 25 个字符。 |
MessagePlaceholderField
Message 占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
BUSINESS_NAME |
数据类型:STRING。您的商家的名称。 |
COUNTRY_CODE |
数据类型:STRING。电话号码的国家/地区代码。 |
PHONE_NUMBER |
数据类型:STRING。能够收发短信的电话号码。 |
MESSAGE_EXTENSION_TEXT |
数据类型:STRING。将出现在您的“点击发短信”广告中的文字。 |
MESSAGE_TEXT |
数据类型:STRING。当用户点按短信图标给您发消息时,短信文字会自动显示在对方的短信应用中。 |
PricePlaceholderField
“价格”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
TYPE |
数据类型:STRING。价格 Feed 的类型。必须与某个预定义的价格 Feed 类型完全匹配。 |
PRICE_QUALIFIER |
数据类型:STRING。每个价格的限定词。必须与预定义的某个价格限定词完全匹配。 |
TRACKING_TEMPLATE |
数据类型:网址。使用升级版网址时的价格 Feed 跟踪模板。 |
LANGUAGE |
数据类型:STRING。价格 Feed 的语言。必须与可用的区域代码之一完全一致。 |
FINAL_URL_SUFFIX |
数据类型:STRING。使用并行跟踪时价格 Feed 的最终到达网址后缀。 |
ITEM_1_HEADER |
数据类型:STRING。表格中第 1 项的标题。 |
ITEM_1_DESCRIPTION |
数据类型:STRING。表中第 1 项的说明。 |
ITEM_1_PRICE |
数据类型:MONEY。表格中商品 1 的价格(带货币的货币),例如 30 USD。币种必须与适用的币种之一相符。 |
ITEM_1_UNIT |
数据类型:STRING。表中商品 1 的价格单位。必须与其中一个预定义的价格单位一致。 |
ITEM_1_FINAL_URLS |
数据类型:网址_LIST。表格中项目 1 的最终到达网址(使用升级版网址时)。 |
ITEM_1_FINAL_MOBILE_URLS |
数据类型:网址_LIST。表格中项目 1 的最终到达移动网址(在使用升级版网址时)。 |
ITEM_2_HEADER |
数据类型:STRING。表格中第 2 项的标题。 |
ITEM_2_DESCRIPTION |
数据类型:STRING。表中第 2 项的说明。 |
ITEM_2_PRICE |
数据类型:MONEY。表格中商品 2 的价格(带货币的货币),例如 30 USD。币种必须与适用的币种之一相符。 |
ITEM_2_UNIT |
数据类型:STRING。表中商品 2 的价格单位。必须与其中一个预定义的价格单位一致。 |
ITEM_2_FINAL_URLS |
数据类型:网址_LIST。表格中项目 2 的最终到达网址(使用升级版网址时)。 |
ITEM_2_FINAL_MOBILE_URLS |
数据类型:网址_LIST。表格中项目 2 的最终到达移动网址(在使用升级版网址时)。 |
ITEM_3_HEADER |
数据类型:STRING。表格中第 3 项的标题。 |
ITEM_3_DESCRIPTION |
数据类型:STRING。表中第 3 项的说明。 |
ITEM_3_PRICE |
数据类型:MONEY。表格中商品 3 的价格(带货币的货币),例如 30 USD。币种必须与适用的币种之一相符。 |
ITEM_3_UNIT |
数据类型:STRING。表中商品 3 的价格单位。必须与其中一个预定义的价格单位一致。 |
ITEM_3_FINAL_URLS |
数据类型:网址_LIST。表中第 3 项的最终到达网址(使用升级版网址时)。 |
ITEM_3_FINAL_MOBILE_URLS |
数据类型:网址_LIST。表格中项目 3 的最终到达移动网址(在使用升级版网址时)。 |
ITEM_4_HEADER |
数据类型:STRING。表格中第 4 项的标题。 |
ITEM_4_DESCRIPTION |
数据类型:STRING。表中第 4 项的说明。 |
ITEM_4_PRICE |
数据类型:MONEY。表格中商品 4 的价格(带货币的货币),例如 30 USD。币种必须与适用的币种之一相符。 |
ITEM_4_UNIT |
数据类型:STRING。表中商品 4 的价格单位。必须与其中一个预定义的价格单位一致。 |
ITEM_4_FINAL_URLS |
数据类型:网址_LIST。表格中项目 4 的最终到达网址(使用升级版网址时)。 |
ITEM_4_FINAL_MOBILE_URLS |
数据类型:网址_LIST。表格中项目 4 的最终到达移动网址(在使用升级版网址时)。 |
ITEM_5_HEADER |
数据类型:STRING。表格中第 5 项的标题。 |
ITEM_5_DESCRIPTION |
数据类型:STRING。表中第 5 项的说明。 |
ITEM_5_PRICE |
数据类型:MONEY。表格中商品 5 的价格(带货币的货币),例如 30 USD。币种必须与适用的币种之一相符。 |
ITEM_5_UNIT |
数据类型:STRING。表中商品 5 的价格单位。必须与其中一个预定义的价格单位一致。 |
ITEM_5_FINAL_URLS |
数据类型:网址_LIST。表格中项目 5 的最终到达网址(使用升级版网址时)。 |
ITEM_5_FINAL_MOBILE_URLS |
数据类型:网址_LIST。表格中项目 5 的最终到达移动网址(使用升级版网址时)。 |
ITEM_6_HEADER |
数据类型:STRING。表格中第 6 项的标题。 |
ITEM_6_DESCRIPTION |
数据类型:STRING。表中第 6 项的说明。 |
ITEM_6_PRICE |
数据类型:MONEY。表格中商品 6 的价格(带货币的货币),例如 30 USD。币种必须与适用的币种之一相符。 |
ITEM_6_UNIT |
数据类型:STRING。表中商品 6 的价格单位。必须与其中一个预定义的价格单位一致。 |
ITEM_6_FINAL_URLS |
数据类型:网址_LIST。表格中项目 6 的最终到达网址(使用升级版网址时)。 |
ITEM_6_FINAL_MOBILE_URLS |
数据类型:网址_LIST。表格中项目 6 的最终到达移动网址(使用升级版网址时)。 |
ITEM_7_HEADER |
数据类型:STRING。表格中第 7 项的标题。 |
ITEM_7_DESCRIPTION |
数据类型:STRING。表中第 7 项的说明。 |
ITEM_7_PRICE |
数据类型:MONEY。表格中商品 7 的价格(带货币的货币),例如 30 USD。币种必须与适用的币种之一相符。 |
ITEM_7_UNIT |
数据类型:STRING。表中商品 7 的价格单位。必须与其中一个预定义的价格单位一致。 |
ITEM_7_FINAL_URLS |
数据类型:网址_LIST。表格中项目 7 的最终到达网址(使用升级版网址时)。 |
ITEM_7_FINAL_MOBILE_URLS |
数据类型:网址_LIST。表格中项目 7 的最终到达移动网址(使用升级版网址时)。 |
ITEM_8_HEADER |
数据类型:STRING。表中第 8 项的标题。 |
ITEM_8_DESCRIPTION |
数据类型:STRING。表中第 8 项的说明。 |
ITEM_8_PRICE |
数据类型:MONEY。表格中商品 8 的价格(带货币的货币),例如 30 USD。币种必须与适用的币种之一相符。 |
ITEM_8_UNIT |
数据类型:STRING。表中商品 8 的价格单位。必须与其中一个预定义的价格单位一致。 |
ITEM_8_FINAL_URLS |
数据类型:网址_LIST。表格中项目 8 的最终到达网址(使用升级版网址时)。 |
ITEM_8_FINAL_MOBILE_URLS |
数据类型:网址_LIST。表格中项目 8 的最终到达移动网址(使用升级版网址时)。 |
PromotionPlaceholderField
“促销”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PROMOTION_TARGET |
数据类型:STRING。展示附加信息时在广告中显示的文字。 |
DISCOUNT_MODIFIER |
数据类型:STRING。允许您在促销活动中添加“高达”短语,以防您采用不同的促销费率。 |
PERCENT_OFF |
数据类型:INT64。采用以微单位表示的值,其中 100 万个微单位表示 1%,呈现时显示为百分比。 |
MONEY_AMOUNT_OFF |
数据类型:MONEY。需要货币和金额。 |
PROMOTION_CODE |
数据类型:STRING。用户获取折扣时输入的字符串。 |
ORDERS_OVER_AMOUNT |
数据类型:MONEY。用户需要达到的最低消费金额,才有资格享受促销优惠。 |
PROMOTION_START |
数据类型:DATE。促销的开始日期。 |
PROMOTION_END |
数据类型:DATE。促销的结束日期。 |
OCCASION |
数据类型:STRING。使用 PromotionExtensionOccasion 枚举值之一(例如 NEW_YEARS)描述促销的相关事件。 |
FINAL_URLS |
数据类型:网址_LIST。使用升级版网址时要在广告中使用的最终到达网址。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。广告的最终到达移动网址(使用升级版网址时)。 |
TRACKING_URL |
数据类型:网址。广告的跟踪模板(使用升级版网址时)。 |
LANGUAGE |
数据类型:STRING。由促销活动的语言代码表示的字符串。 |
FINAL_URL_SUFFIX |
数据类型:STRING。使用并行跟踪时广告的最终到达网址后缀。 |
AdCustomizerPlaceholderField
广告定制参数占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
INTEGER |
数据类型:INT64。要插入的整数值。 |
PRICE |
数据类型:STRING。要插入的价格值。 |
DATE |
数据类型:DATE_TIME。要插入的日期值。 |
STRING |
数据类型:STRING。要插入的字符串值。 |
DsaPageFeedCriterionField
动态搜索广告页面 Feed 条件字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PAGE_URL |
数据类型:网址 或 网址_LIST。您要定位的网页的网址。 |
LABEL |
数据类型:STRING_LIST。页面 Feed 中可帮助您定位广告的标签。 |
LocationExtensionTargetingCriterionField
附加地址信息定位条件字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ADDRESS_LINE_1 |
数据类型:STRING。商家地址的第 1 行。 |
ADDRESS_LINE_2 |
数据类型:STRING。商家地址的第 2 行。 |
CITY |
数据类型:STRING。商家地址所在的城市。 |
PROVINCE |
数据类型:STRING。商家地址所在的省/自治区/直辖市。 |
POSTAL_CODE |
数据类型:STRING。商家地址所属的邮政编码。 |
COUNTRY_CODE |
数据类型:STRING。商家地址的国家/地区代码。 |
EducationPlaceholderField
“教育”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PROGRAM_ID |
数据类型:STRING。必需。每个优惠的 PROGRAM ID 和 LOCATION ID 组合都必须是唯一的。 |
LOCATION_ID |
数据类型:STRING。每个优惠的 PROGRAM ID 和 LOCATION ID 组合都必须是唯一的。 |
PROGRAM_NAME |
数据类型:STRING。必需。要在动态广告中显示的主标题及计划名称。 |
AREA_OF_STUDY |
数据类型:STRING。可以在动态广告中展示的研究领域。 |
PROGRAM_DESCRIPTION |
数据类型:STRING。可在动态广告中展示的计划说明。 |
SCHOOL_NAME |
数据类型:STRING。可在动态广告中显示的学校名称。 |
ADDRESS |
数据类型:STRING。完整的学校地址(包括邮政编码)。 |
THUMBNAIL_IMAGE_URL |
数据类型:网址。要在广告中展示的图片。 |
ALTERNATIVE_THUMBNAIL_IMAGE_URL |
数据类型:网址。要在广告中使用的替代托管图片文件。 |
FINAL_URLS |
数据类型:网址_LIST。必需。使用升级版网址时在广告中使用的最终到达网址;越具体越好(例如,具体活动的具体网址及其位置)。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。广告的最终到达移动网址(使用升级版网址时)。 |
TRACKING_URL |
数据类型:网址。广告的跟踪模板(使用升级版网址时)。 |
CONTEXTUAL_KEYWORDS |
数据类型:STRING_LIST。用于商品检索的关键字。 |
ANDROID_APP_LINK |
数据类型:STRING。Android 应用链接。格式必须为:android-app://{package_id}/{scheme}/{host_path}。组件的定义如下:package_id:Google Play 中指定的应用 ID。scheme:要传递给应用的架构。可以是 HTTP,也可以是自定义架构。host_path:用于标识应用内的特定内容。 |
SIMILAR_PROGRAM_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐计划 ID 列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
FlightPlaceholderField
“广告投放”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
DESTINATION_ID |
数据类型:STRING。必需。目的地 ID。例如:PAR、LON。对于只有目标平台 ID 的 Feed 项,目标平台 ID 必须是唯一键。对于同时包含目的地 ID 和出发地 ID 的 Feed 项,该组合键必须是唯一键。 |
ORIGIN_ID |
数据类型:STRING。出发地 ID。例如:PAR、LON。可选。每件商品的目的地 ID 和出发地 ID 的组合必须是唯一的。 |
FLIGHT_DESCRIPTION |
数据类型:STRING。必需。要在动态广告中显示的主标题及产品名称。 |
ORIGIN_NAME |
数据类型:STRING。建议使用短名称。 |
DESTINATION_NAME |
数据类型:STRING。建议使用短名称。 |
FLIGHT_PRICE |
数据类型:STRING。要在广告中显示的价格。示例:“100.00 USD” |
FORMATTED_PRICE |
数据类型:STRING。要在广告中显示的统一格式的价格。示例:“起价 100.00 美元”、“80 - 100 美元” |
FLIGHT_SALE_PRICE |
数据类型:STRING。要在广告中展示的促销价。示例:“80.00 USD” |
FORMATTED_SALE_PRICE |
数据类型:STRING。要在广告中展示的统一格式的促销价。示例:“促销价为 80.00 美元”“60 - 80 美元” |
IMAGE_URL |
数据类型:网址。要在广告中展示的图片。 |
FINAL_URLS |
数据类型:网址_LIST。必需。使用升级版网址时广告的最终到达网址。当用户点击广告或展示多个航班的广告的特定航班时,将被重定向到这些网址。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。广告的最终到达移动网址(使用升级版网址时)。 |
TRACKING_URL |
数据类型:网址。广告的跟踪模板(使用升级版网址时)。 |
ANDROID_APP_LINK |
数据类型:STRING。Android 应用链接。格式必须为:android-app://{package_id}/{scheme}/{host_path}。组件的定义如下:package_id:Google Play 中指定的应用 ID。scheme:要传递给应用的架构。可以是 HTTP,也可以是自定义架构。host_path:用于标识应用内的特定内容。 |
SIMILAR_DESTINATION_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐目的地 ID 列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
CustomPlaceholderField
自定义占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ID |
数据类型:STRING。必需。每项优惠的组合 ID 和 ID2 必须是唯一的。 |
ID2 |
数据类型:STRING。每项优惠的组合 ID 和 ID2 必须是唯一的。 |
ITEM_TITLE |
数据类型:STRING。必需。要在动态广告中显示的主标题及产品名称。 |
ITEM_SUBTITLE |
数据类型:STRING。要在图片广告中显示的可选文字。 |
ITEM_DESCRIPTION |
数据类型:STRING。要在广告中展示的产品的可选说明。 |
ITEM_ADDRESS |
数据类型:STRING。优惠或服务的完整地址,包括邮政编码。当 Feed 中有多个与用户相关的商品时,此属性将用于识别距离用户最近的商品。 |
PRICE |
数据类型:STRING。要在广告中显示的价格。示例:“100.00 USD” |
FORMATTED_PRICE |
数据类型:STRING。要在广告中显示的统一格式的价格。示例:“起价 100.00 美元”、“80 - 100 美元” |
SALE_PRICE |
数据类型:STRING。要在广告中展示的促销价。示例:“80.00 USD” |
FORMATTED_SALE_PRICE |
数据类型:STRING。要在广告中展示的统一格式的促销价。示例:“促销价为 80.00 美元”“60 - 80 美元” |
IMAGE_URL |
数据类型:网址。要在广告中展示的图片。强烈建议用于图片广告。 |
ITEM_CATEGORY |
数据类型:STRING。用作商品推荐引擎信号,以投放同一类别中的商品。 |
FINAL_URLS |
数据类型:网址_LIST。使用升级版网址时广告的最终到达网址。当用户点击广告或包含多款产品的广告中的具体产品时,系统会将他们重定向到这些网址。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。广告的最终到达移动网址(使用升级版网址时)。 |
TRACKING_URL |
数据类型:网址。广告的跟踪模板(使用升级版网址时)。 |
CONTEXTUAL_KEYWORDS |
数据类型:STRING_LIST。用于商品检索的关键字。 |
ANDROID_APP_LINK |
数据类型:STRING。Android 应用链接。格式必须为:android-app://{package_id}/{scheme}/{host_path}。组件的定义如下:package_id:Google Play 中指定的应用 ID。scheme:要传递给应用的架构。可以是 HTTP,也可以是自定义架构。host_path:用于标识应用内的特定内容。 |
SIMILAR_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐 ID 列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
HotelPlaceholderField
“酒店”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PROPERTY_ID |
数据类型:STRING。必需。唯一 ID。 |
PROPERTY_NAME |
数据类型:STRING。必需。要在动态广告中显示的主标题及媒体资源名称。 |
DESTINATION_NAME |
数据类型:STRING。要在动态广告中显示的目标页面的名称。 |
DESCRIPTION |
数据类型:STRING。要在动态广告中展示的目标页面的说明。 |
ADDRESS |
数据类型:STRING。完整的房源地址,包括邮政编码。 |
PRICE |
数据类型:STRING。要在广告中显示的价格。示例:“100.00 USD” |
FORMATTED_PRICE |
数据类型:STRING。要在广告中显示的统一格式的价格。示例:“起价 100.00 美元”、“80 - 100 美元” |
SALE_PRICE |
数据类型:STRING。要在广告中展示的促销价。示例:“80.00 USD” |
FORMATTED_SALE_PRICE |
数据类型:STRING。要在广告中展示的统一格式的促销价。示例:“促销价为 80.00 美元”“60 - 80 美元” |
IMAGE_URL |
数据类型:网址。要在广告中展示的图片。 |
CATEGORY |
数据类型:STRING。用于为商品推荐引擎将相似项组合在一起的属性类别。 |
STAR_RATING |
数据类型:INT64。星级(1 到 5),用于将相似的项目归为一组,以用于推荐引擎。 |
CONTEXTUAL_KEYWORDS |
数据类型:STRING_LIST。用于商品检索的关键字。 |
FINAL_URLS |
数据类型:网址_LIST。必需。使用升级版网址时广告的最终到达网址。当用户点击广告或展示多个航班的广告的特定航班时,将被重定向到这些网址。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。广告的最终到达移动网址(使用升级版网址时)。 |
TRACKING_URL |
数据类型:网址。广告的跟踪模板(使用升级版网址时)。 |
ANDROID_APP_LINK |
数据类型:STRING。Android 应用链接。格式必须为:android-app://{package_id}/{scheme}/{host_path}。组件的定义如下:package_id:Google Play 中指定的应用 ID。scheme:要传递给应用的架构。可以是 HTTP,也可以是自定义架构。host_path:用于标识应用内的特定内容。 |
SIMILAR_PROPERTY_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐物业 ID 列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
RealEstatePlaceholderField
房地产占位字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
LISTING_ID |
数据类型:STRING。唯一 ID。 |
LISTING_NAME |
数据类型:STRING。要在动态广告中显示的主标题及房源名称。 |
CITY_NAME |
数据类型:STRING。要在动态广告中显示的城市名称。 |
DESCRIPTION |
数据类型:STRING。要在动态广告中展示的商家信息说明。 |
ADDRESS |
数据类型:STRING。完整的商家信息地址,包括邮政编码。 |
PRICE |
数据类型:STRING。要在广告中显示的价格。示例:“100.00 USD” |
FORMATTED_PRICE |
数据类型:STRING。要在广告中显示的统一格式的价格。示例:“起价 100.00 美元”、“80 - 100 美元” |
IMAGE_URL |
数据类型:网址。要在广告中展示的图片。 |
PROPERTY_TYPE |
数据类型:STRING。用于将相似的项目归为一组,以用于推荐引擎的房源类型(房屋、公寓、公寓等)。 |
LISTING_TYPE |
数据类型:STRING。用于将类似商品归为一组,以用于推荐引擎的商品详情类型(转售、租借、断供房出售等)。 |
CONTEXTUAL_KEYWORDS |
数据类型:STRING_LIST。用于商品检索的关键字。 |
FINAL_URLS |
数据类型:网址_LIST。使用升级版网址时在广告中使用的最终到达网址;越具体越好(例如,具体商家信息中的具体网址及其位置)。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。广告的最终到达移动网址(使用升级版网址时)。 |
TRACKING_URL |
数据类型:网址。广告的跟踪模板(使用升级版网址时)。 |
ANDROID_APP_LINK |
数据类型:STRING。Android 应用链接。格式必须为:android-app://{package_id}/{scheme}/{host_path}。组件的定义如下:package_id:Google Play 中指定的应用 ID。scheme:要传递给应用的架构。可以是 HTTP,也可以是自定义架构。host_path:用于标识应用内的特定内容。 |
SIMILAR_LISTING_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐房源 ID 的列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
TravelPlaceholderField
“Travel”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
DESTINATION_ID |
数据类型:STRING。必需。目的地 ID。例如:PAR、LON。对于只有目标平台 ID 的 Feed 项,目标平台 ID 必须是唯一键。对于同时包含目的地 ID 和出发地 ID 的 Feed 项,该组合键必须是唯一键。 |
ORIGIN_ID |
数据类型:STRING。出发地 ID。例如:PAR、LON。每项优惠的 DESTINATION_ID 和 ORIGIN_ID 组合必须唯一。 |
TITLE |
数据类型:STRING。必需。要在动态广告中显示的主标题及名称。 |
DESTINATION_NAME |
数据类型:STRING。目的地名称。建议使用短名称。 |
ORIGIN_NAME |
数据类型:STRING。出发地名称。建议使用短名称。 |
PRICE |
数据类型:STRING。要在广告中显示的价格。强烈建议用于动态广告。示例:“100.00 USD” |
FORMATTED_PRICE |
数据类型:STRING。要在广告中显示的统一格式的价格。示例:“起价 100.00 美元”、“80 - 100 美元” |
SALE_PRICE |
数据类型:STRING。要在广告中展示的促销价。示例:“80.00 USD” |
FORMATTED_SALE_PRICE |
数据类型:STRING。要在广告中展示的统一格式的促销价。示例:“促销价为 80.00 美元”“60 - 80 美元” |
IMAGE_URL |
数据类型:网址。要在广告中展示的图片。 |
CATEGORY |
数据类型:STRING。用于将相似的商品归为一组,以用于推荐引擎的旅行优惠类别。 |
CONTEXTUAL_KEYWORDS |
数据类型:STRING_LIST。用于商品检索的关键字。 |
DESTINATION_ADDRESS |
数据类型:STRING。旅行优惠的地址,包括邮政编码。 |
FINAL_URL |
数据类型:网址_LIST。必需。使用升级版网址时,在广告中使用的最终到达网址;越具体越好(例如,具体旅行优惠的具体网址及其位置)。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。广告的最终到达移动网址(使用升级版网址时)。 |
TRACKING_URL |
数据类型:网址。广告的跟踪模板(使用升级版网址时)。 |
ANDROID_APP_LINK |
数据类型:STRING。Android 应用链接。格式必须为:android-app://{package_id}/{scheme}/{host_path}。组件的定义如下:package_id:Google Play 中指定的应用 ID。scheme:要传递给应用的架构。可以是 HTTP,也可以是自定义架构。host_path:用于标识应用内的特定内容。 |
SIMILAR_DESTINATION_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐目的地 ID 列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
LocalPlaceholderField
Local 占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
DEAL_ID |
数据类型:STRING。必需。唯一 ID。 |
DEAL_NAME |
数据类型:STRING。必需。要在动态广告中显示的主标题及本地优惠标题。 |
SUBTITLE |
数据类型:STRING。要在动态广告中显示的本地优惠副标题。 |
DESCRIPTION |
数据类型:STRING。要在动态广告中展示的本地优惠的说明。 |
PRICE |
数据类型:STRING。要在广告中显示的价格。强烈建议用于动态广告。示例:“100.00 USD” |
FORMATTED_PRICE |
数据类型:STRING。要在广告中显示的统一格式的价格。示例:“起价 100.00 美元”、“80 - 100 美元” |
SALE_PRICE |
数据类型:STRING。要在广告中展示的促销价。示例:“80.00 USD” |
FORMATTED_SALE_PRICE |
数据类型:STRING。要在广告中展示的统一格式的促销价。示例:“促销价为 80.00 美元”“60 - 80 美元” |
IMAGE_URL |
数据类型:网址。要在广告中展示的图片。 |
ADDRESS |
数据类型:STRING。完整的房源地址,包括邮政编码。 |
CATEGORY |
数据类型:STRING。本地优惠的类别,用于将类似的商品组合在一起,以便推荐引擎。 |
CONTEXTUAL_KEYWORDS |
数据类型:STRING_LIST。用于商品检索的关键字。 |
FINAL_URLS |
数据类型:网址_LIST。必需。使用升级版网址时在广告中使用的最终到达网址;越具体越好(例如,具体本地优惠的具体网址及其位置)。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。广告的最终到达移动网址(使用升级版网址时)。 |
TRACKING_URL |
数据类型:网址。广告的跟踪模板(使用升级版网址时)。 |
ANDROID_APP_LINK |
数据类型:STRING。Android 应用链接。格式必须为:android-app://{package_id}/{scheme}/{host_path}。组件的定义如下:package_id:Google Play 中指定的应用 ID。scheme:要传递给应用的架构。可以是 HTTP,也可以是自定义架构。host_path:用于标识应用内的特定内容。 |
SIMILAR_DEAL_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐本地优惠 ID 的列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
JobPlaceholderField
作业占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
JOB_ID |
数据类型:STRING。必需。如果仅指定了 JOB_ID,则该 ID 必须是唯一的。如果同时指定了 JOB_ID 和 LOCATION_ID,则该对必须是唯一的。必须是唯一的。 |
LOCATION_ID |
数据类型:STRING。每件商品的 JOB_ID 和 LOCATION_ID 组合都必须是唯一的。 |
TITLE |
数据类型:STRING。必需。要在动态广告中显示的主标题及职位名称。 |
SUBTITLE |
数据类型:STRING。要在动态广告中显示的职位副标题。 |
DESCRIPTION |
数据类型:STRING。要在动态广告中显示的职位说明。 |
IMAGE_URL |
数据类型:网址。要在广告中展示的图片。强烈建议用于图片广告。 |
CATEGORY |
数据类型:STRING。用于为商品推荐引擎将相似项组合在一起的属性类别。 |
CONTEXTUAL_KEYWORDS |
数据类型:STRING_LIST。用于商品检索的关键字。 |
ADDRESS |
数据类型:STRING。完整的房源地址,包括邮政编码。 |
SALARY |
数据类型:STRING。在动态广告中展示的职位的薪资或薪资范围。 |
FINAL_URLS |
数据类型:网址_LIST。必需。使用升级版网址时在广告中使用的最终到达网址;越具体越好(例如,具体招聘信息的具体网址及其位置)。 |
FINAL_MOBILE_URLS |
数据类型:网址_LIST。广告的最终到达移动网址(使用升级版网址时)。 |
TRACKING_URL |
数据类型:网址。广告的跟踪模板(使用升级版网址时)。 |
ANDROID_APP_LINK |
数据类型:STRING。Android 应用链接。格式必须为:android-app://{package_id}/{scheme}/{host_path}。组件的定义如下:package_id:Google Play 中指定的应用 ID。scheme:要传递给应用的架构。可以是 HTTP,也可以是自定义架构。host_path:用于标识应用内的特定内容。 |
SIMILAR_JOB_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐作业 ID 列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
ImagePlaceholderField
“广告客户提供的图片”占位符字段的可能值。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ASSET_ID |
数据类型:INT64。图片的素材资源 ID。 |
FeedMappingStatus
Feed 映射的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ENABLED |
Feed 映射已启用。 |
REMOVED |
Feed 映射已被移除。 |
FeedMappingCriterionType
Feed 映射可能适用的占位符类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
LOCATION_EXTENSION_TARGETING |
允许广告系列定位到地理位置 Feed 中的地理位置。 |
DSA_PAGE_FEED |
允许对页面 Feed 中的动态搜索广告进行网址定位。 |