FeedMapping

Feed 映射。

JSON 表示法
{
  "resourceName": string,
  "attributeFieldMappings": [
    {
      object (AttributeFieldMapping)
    }
  ],
  "status": enum (FeedMappingStatus),
  "feed": string,

  // Union field target can be only one of the following:
  "placeholderType": enum (PlaceholderType),
  "criterionType": enum (FeedMappingCriterionType)
  // End of list of possible types for union field target.
}
字段
resourceName

string

不可变。Feed 映射的资源名称。Feed 映射资源名称采用以下格式:

customers/{customerId}/feedMappings/{feedId}~{feed_mapping_id}

attributeFieldMappings[]

object (AttributeFieldMapping)

不可变。Feed 属性到字段的映射。这些映射属于一对多关系,这意味着 1 个 Feed 属性可用于填充多个占位符字段,但 1 个占位符字段只能从 1 个 Feed 属性中提取数据。广告定制工具除外,1 个占位符字段可映射到多个 Feed 属性。必填。

status

enum (FeedMappingStatus)

仅供输出。Feed 映射的状态。此字段为只读字段。

feed

string

不可变。此 Feed 映射的 Feed。

联合字段 target。Feed 映射目标。可以是占位符或条件。对于给定的 Feed,有效的 FeedMapping 必须具有唯一的定位条件。必需。target 只能是下列其中一项:
placeholderType

enum (PlaceholderType)

不可变。此映射的占位符类型(例如,如果映射将 Feed 属性映射到占位符字段)。

criterionType

enum (FeedMappingCriterionType)

不可变。此映射的条件类型(例如,如果映射将 Feed 属性映射到条件字段)。

AttributeFieldMapping

从 Feed 属性 ID 到占位符或条件字段 ID 的映射。

JSON 表示法
{
  "feedAttributeId": string,
  "fieldId": string,

  // Union field field can be only one of the following:
  "sitelinkField": enum (SitelinkPlaceholderField),
  "callField": enum (CallPlaceholderField),
  "appField": enum (AppPlaceholderField),
  "locationField": enum (LocationPlaceholderField),
  "affiliateLocationField": enum (AffiliateLocationPlaceholderField),
  "calloutField": enum (CalloutPlaceholderField),
  "structuredSnippetField": enum (StructuredSnippetPlaceholderField),
  "messageField": enum (MessagePlaceholderField),
  "priceField": enum (PricePlaceholderField),
  "promotionField": enum (PromotionPlaceholderField),
  "adCustomizerField": enum (AdCustomizerPlaceholderField),
  "dsaPageFeedField": enum (DsaPageFeedCriterionField),
  "locationExtensionTargetingField": enum (LocationExtensionTargetingCriterionField),
  "educationField": enum (EducationPlaceholderField),
  "flightField": enum (FlightPlaceholderField),
  "customField": enum (CustomPlaceholderField),
  "hotelField": enum (HotelPlaceholderField),
  "realEstateField": enum (RealEstatePlaceholderField),
  "travelField": enum (TravelPlaceholderField),
  "localField": enum (LocalPlaceholderField),
  "jobField": enum (JobPlaceholderField),
  "imageField": enum (ImagePlaceholderField)
  // End of list of possible types for union field field.
}
字段
feedAttributeId

string (int64 format)

不可变。作为映射来源的 Feed 属性。

fieldId

string (int64 format)

仅供输出。占位符字段 ID。如果占位符字段枚举未在当前 API 版本中发布,系统将填充此字段,且字段 oneof 将为空。此字段为只读字段。

联合字段 field。使用上述 Feed 属性中的数据填充的占位符或条件字段。必需。field 只能是下列其中一项:
callField

enum (CallPlaceholderField)

不可变。调用占位符字段。

appField

enum (AppPlaceholderField)

不可变。应用占位符字段。

locationField

enum (LocationPlaceholderField)

仅供输出。位置占位符字段。此字段为只读字段。

affiliateLocationField

enum (AffiliateLocationPlaceholderField)

仅供输出。关联商户地址占位符字段。此字段为只读字段。

calloutField

enum (CalloutPlaceholderField)

不可变。宣传信息占位符字段。

structuredSnippetField

enum (StructuredSnippetPlaceholderField)

不可变。结构化摘要占位符字段。

messageField

enum (MessagePlaceholderField)

不可变。消息占位符字段。

priceField

enum (PricePlaceholderField)

不可变。价格占位符字段。

promotionField

enum (PromotionPlaceholderField)

不可变。促销信息占位符字段。

adCustomizerField

enum (AdCustomizerPlaceholderField)

不可变。广告定制工具占位符字段

dsaPageFeedField

enum (DsaPageFeedCriterionField)

不可变。动态搜索广告页面 Feed 字段。

locationExtensionTargetingField

enum (LocationExtensionTargetingCriterionField)

不可变。地理位置定位目标字段。

educationField

enum (EducationPlaceholderField)

不可变。教育占位符字段

flightField

enum (FlightPlaceholderField)

不可变。广告投放占位符字段

customField

enum (CustomPlaceholderField)

不可变。自定义占位符字段

hotelField

enum (HotelPlaceholderField)

不可变。酒店占位符字段

realEstateField

enum (RealEstatePlaceholderField)

不可变。房地产占位符字段

travelField

enum (TravelPlaceholderField)

不可变。旅行占位符字段

localField

enum (LocalPlaceholderField)

不可变。本地占位符字段

jobField

enum (JobPlaceholderField)

不可变。作业占位符字段

imageField

enum (ImagePlaceholderField)

不可变。图片占位符字段

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。
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。用于商品检索的关键字。
SIMILAR_PROGRAM_IDS 数据类型:STRING_LIST。与此商品一起显示的推荐计划 ID 列表。
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 数据类型:网址。广告的跟踪模板(使用升级版网址时)。
SIMILAR_DESTINATION_IDS 数据类型:STRING_LIST。与此商品一起显示的推荐目的地 ID 列表。
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。用于商品检索的关键字。
SIMILAR_IDS 数据类型:STRING_LIST。与此商品一起显示的推荐 ID 列表。
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 数据类型:网址。广告的跟踪模板(使用升级版网址时)。
SIMILAR_PROPERTY_IDS 数据类型:STRING_LIST。与此商品一起显示的推荐物业 ID 列表。
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 数据类型:网址。广告的跟踪模板(使用升级版网址时)。
SIMILAR_LISTING_IDS 数据类型:STRING_LIST。与此商品一起显示的推荐房源 ID 的列表。
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 数据类型:网址。广告的跟踪模板(使用升级版网址时)。
SIMILAR_DESTINATION_IDS 数据类型:STRING_LIST。与此商品一起显示的推荐目的地 ID 列表。
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 数据类型:网址。广告的跟踪模板(使用升级版网址时)。
SIMILAR_DEAL_IDS 数据类型:STRING_LIST。与此商品一起显示的推荐本地优惠 ID 的列表。
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 数据类型:网址。广告的跟踪模板(使用升级版网址时)。
SIMILAR_JOB_IDS 数据类型:STRING_LIST。与此商品一起显示的推荐作业 ID 列表。
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 中的动态搜索广告进行网址定位。