注意：您正在查看 API 的 REST 接口的文档。我们的大多数官方客户端库都使用 gRPC。如需了解详情，请参阅 REST 简介。

此页面由 Cloud Translation API 翻译。

FeedMapping

JSON 表示法
AttributeFieldMapping
- 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 表示法

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,
  "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 表示法

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,
  "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` 只能是下列其中一项：
`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)` 不可变。动态搜索广告页面 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 Store。
`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。必需。每个优惠的 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

“旅行”占位符字段的可能值。

枚举
`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

本地占位符字段的可能值。

枚举
`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，则必须唯一。如果同时指定了 JOB_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，也可以是自定义架构。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 中的动态搜索广告进行网址定位。