- JSON 表示法
- AttributeFieldMapping
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 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 版本中未发布占位符字段枚举,则将填充此字段,且 Field 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。此对象包含 phoneCallDuration 字段,此字段是被视为转化的最短通话时长(以秒为单位)。 |
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
位置占位符字段的可能值。
枚举 | |
---|---|
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
消息占位符字段的可能值。
枚举 | |
---|---|
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。必需。每项优惠的计划 ID 和地理位置 ID 的组合必须是唯一的。 |
LOCATION_ID |
数据类型:STRING。每项优惠的计划 ID 和地理位置 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,也可以是自定义 scheme。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,也可以是自定义 scheme。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,也可以是自定义 scheme。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,也可以是自定义 scheme。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,也可以是自定义 scheme。host_path:指定应用内的具体内容。 |
SIMILAR_LISTING_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐房源 ID 列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
TravelPlaceholderField
旅游占位符字段的可能值。
枚举 | |
---|---|
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,也可以是自定义 scheme。host_path:指定应用内的具体内容。 |
SIMILAR_DESTINATION_IDS |
数据类型:STRING_LIST。与此商品一起显示的推荐目的地 ID 列表。 |
IOS_APP_LINK |
数据类型:STRING。iOS 应用链接。 |
IOS_APP_STORE_ID |
数据类型:INT64。iOS App Store ID。 |
LocalPlaceholderField
本地占位符字段的可能值。
枚举 | |
---|---|
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,也可以是自定义 scheme。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,则必须唯一。如果同时指定了 JOB_ID 和 LOCATION_ID,则 LOCATION_ID 对必须是唯一的。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,也可以是自定义 scheme。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 内对动态搜索广告进行网址定位。 |