注意：您正在查看 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

動態饋給對應。

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` 無法變更。動態饋給對應的資源名稱。動態饋給對應資源名稱的格式為： `customers/{customerId}/feedMappings/{feedId}~{feed_mapping_id}`
`attributeFieldMappings[]`	`object (AttributeFieldMapping)` 無法變更。將動態饋給屬性對應至欄位對應。這些對應是一對多關係，意即 1 個動態饋給屬性可用於填入多個預留位置欄位，但 1 個預留位置欄位只能從 1 個動態饋給屬性擷取資料。廣告自訂參數為例外情況，1 個預留位置欄位可對應至多個動態饋給屬性。這是必填欄位。
`status`	`enum (FeedMappingStatus)` 僅供輸出。動態饋給對應狀態。這是唯讀欄位。
`feed`	`string` 無法變更。此動態饋給對應的動態饋給。
聯集欄位 `target`。動態饋給對應目標。可以是預留位置或條件。針對特定動態饋給，有效的 FeedMappings 必須有不重複的目標。必要欄位。`target` 只能是下列其中一項：
`placeholderType`	`enum (PlaceholderType)` 無法變更。此對應的預留位置類型 (例如，如果將動態饋給屬性對應至預留位置欄位)。
`criterionType`	`enum (FeedMappingCriterionType)` 無法變更。此對應的條件類型 (例如，將動態饋給屬性對應至條件欄位)。

AttributeFieldMapping

將動態饋給屬性 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)` 無法變更。要對應的動態饋給屬性。
`fieldId`	`string (int64 format)` 僅供輸出。預留位置欄位 ID。如果目前 API 版本中沒有發布預留位置欄位列舉，系統會填入這個欄位，其中一個欄位將留空。這是唯讀欄位。
聯集欄位 `field`。使用上述動態饋給屬性資料填入的預留位置或條件欄位。必要欄位。`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)` 無法變更。動態搜尋廣告網頁動態饋給欄位。
`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`	資料類型：URL_LIST。使用升級網址時網站連結的最終到達網址。
`FINAL_MOBILE_URLS`	資料類型：URL_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`	資料類型：URL_LIST。使用升級網址時，應用程式內連結的最終到達網址。
`FINAL_MOBILE_URLS`	資料類型：URL_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。價格動態饋給的類型。必須與其中一個預先定義的價格動態饋給類型完全相符。
`PRICE_QUALIFIER`	資料類型：STRING。每個價格的條件。必須與其中一個預先定義的價格條件完全相符。
`TRACKING_TEMPLATE`	資料類型：網址。使用升級網址時價格動態饋給的追蹤範本。
`LANGUAGE`	資料類型：STRING。價格動態饋給的語言。必須與其中一個可用語言代碼代碼完全相符。
`FINAL_URL_SUFFIX`	資料類型：STRING。使用並行追蹤時，價格動態饋給的最終到達網址尾碼。
`ITEM_1_HEADER`	資料類型：STRING。表格中項目 1 的標題。
`ITEM_1_DESCRIPTION`	資料類型：STRING。表格中項目 1 的說明。
`ITEM_1_PRICE`	資料類型：個資。表格項目 1 的價格 (使用貨幣付款)，例如 30 美元。貨幣必須與其中一種可用貨幣相符。
`ITEM_1_UNIT`	資料類型：STRING。表格中項目 1 的價格單位。必須與其中一個預先定義的價格單位相符。
`ITEM_1_FINAL_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 1 的最終到達網址。
`ITEM_1_FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 1 的最終行動版網址。
`ITEM_2_HEADER`	資料類型：STRING。表格中項目 2 的標題。
`ITEM_2_DESCRIPTION`	資料類型：STRING。表格中項目 2 的說明。
`ITEM_2_PRICE`	資料類型：個資。表格項目 2 的價格 (使用貨幣付款)，例如 30 美元。貨幣必須與其中一種可用貨幣相符。
`ITEM_2_UNIT`	資料類型：STRING。表格中項目 2 的價格單位。必須與其中一個預先定義的價格單位相符。
`ITEM_2_FINAL_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 2 的最終到達網址。
`ITEM_2_FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 2 的最終行動版網址。
`ITEM_3_HEADER`	資料類型：STRING。表格中項目 3 的標題。
`ITEM_3_DESCRIPTION`	資料類型：STRING。表格中項目 3 的說明。
`ITEM_3_PRICE`	資料類型：個資。表格項目 3 的價格 (使用貨幣付款)，例如 30 美元。貨幣必須與其中一種可用貨幣相符。
`ITEM_3_UNIT`	資料類型：STRING。表格中項目 3 的價格單位。必須與其中一個預先定義的價格單位相符。
`ITEM_3_FINAL_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 3 的最終到達網址。
`ITEM_3_FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 3 的最終行動版網址。
`ITEM_4_HEADER`	資料類型：STRING。表格項目 4 的標題。
`ITEM_4_DESCRIPTION`	資料類型：STRING。表格中項目 4 的說明。
`ITEM_4_PRICE`	資料類型：個資。表格項目 4 的價格 (使用貨幣付款)，例如 30 美元。貨幣必須與其中一種可用貨幣相符。
`ITEM_4_UNIT`	資料類型：STRING。表格中項目 4 的價格單位。必須與其中一個預先定義的價格單位相符。
`ITEM_4_FINAL_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 4 的最終到達網址。
`ITEM_4_FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 4 的最終行動版網址。
`ITEM_5_HEADER`	資料類型：STRING。表格項目 5 的標題。
`ITEM_5_DESCRIPTION`	資料類型：STRING。表格中項目 5 的說明。
`ITEM_5_PRICE`	資料類型：個資。表格項目 5 的價格 (使用貨幣付款)，例如 30 美元。貨幣必須與其中一種可用貨幣相符。
`ITEM_5_UNIT`	資料類型：STRING。表格中項目 5 的價格單位。必須與其中一個預先定義的價格單位相符。
`ITEM_5_FINAL_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 5 的最終到達網址。
`ITEM_5_FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 5 的最終行動版網址。
`ITEM_6_HEADER`	資料類型：STRING。表格項目 6 的標題。
`ITEM_6_DESCRIPTION`	資料類型：STRING。表格中項目 6 的說明。
`ITEM_6_PRICE`	資料類型：個資。表格項目 6 的價格 (使用貨幣付款)，例如 30 USD。貨幣必須與其中一種可用貨幣相符。
`ITEM_6_UNIT`	資料類型：STRING。表格中項目 6 的價格單位。必須與其中一個預先定義的價格單位相符。
`ITEM_6_FINAL_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 6 的最終到達網址。
`ITEM_6_FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 6 的最終行動版網址。
`ITEM_7_HEADER`	資料類型：STRING。表格中項目 7 的標題。
`ITEM_7_DESCRIPTION`	資料類型：STRING。表格中項目 7 的說明。
`ITEM_7_PRICE`	資料類型：個資。表格項目 7 的價格 (使用貨幣付款)，例如 30 美元。貨幣必須與其中一種可用貨幣相符。
`ITEM_7_UNIT`	資料類型：STRING。表格中項目 7 的價格單位。必須與其中一個預先定義的價格單位相符。
`ITEM_7_FINAL_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 7 的最終到達網址。
`ITEM_7_FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 7 的最終行動版網址。
`ITEM_8_HEADER`	資料類型：STRING。表格中項目 8 的標題。
`ITEM_8_DESCRIPTION`	資料類型：STRING。表格中項目 8 的說明。
`ITEM_8_PRICE`	資料類型：個資。表格項目 8 的價格 (使用貨幣付款)，例如 30 美元。貨幣必須與其中一種可用貨幣相符。
`ITEM_8_UNIT`	資料類型：STRING。表格中項目 8 的價格單位。必須與其中一個預先定義的價格單位相符。
`ITEM_8_FINAL_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 8 的最終到達網址。
`ITEM_8_FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時，表格項目 8 的最終行動版網址。

PromotionPlaceholderField

可能的「促銷活動」預留位置欄位值。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅適用於傳回值。代表此版本中未知的值。
`PROMOTION_TARGET`	資料類型：STRING。廣告與額外資訊一同顯示時顯示的文字。
`DISCOUNT_MODIFIER`	資料類型：STRING。讓您在促銷活動中加入「最多」這個詞組，以便在促銷活動費率各不相同時使用。
`PERCENT_OFF`	資料類型：INT64。採用以微量為單位的值，其中 100 萬個微量表示 1%，算繪時會以百分比顯示。
`MONEY_AMOUNT_OFF`	資料類型：個資。需要設定貨幣和金額。
`PROMOTION_CODE`	資料類型：STRING。使用者輸入字串來取得折扣。
`ORDERS_OVER_AMOUNT`	資料類型：個資。使用者達到促銷活動資格之前的最低消費金額。
`PROMOTION_START`	資料類型：DATE。促銷活動的開始日期。
`PROMOTION_END`	資料類型：DATE。促銷活動的結束日期。
`OCCASION`	資料類型：STRING。使用其中一個 promotionExtensionOccasion 列舉值描述促銷活動的相關事件，例如 NEW_YEARS。
`FINAL_URLS`	資料類型：URL_LIST。使用升級網址時，廣告要使用的最終到達網址。
`FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時廣告的最終行動版網址。
`TRACKING_URL`	資料類型：網址。使用升級網址時廣告的追蹤範本。
`LANGUAGE`	資料類型：STRING。以促銷代碼表示的字串。
`FINAL_URL_SUFFIX`	資料類型：STRING。使用並行追蹤時的廣告最終到達網址尾碼。

AdCustomizerPlaceholderField

「廣告自訂參數」預留位置欄位可能的值。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅適用於傳回值。代表此版本中未知的值。
`INTEGER`	資料類型：INT64。要插入的整數值。
`PRICE`	資料類型：STRING。要插入的價格值。
`DATE`	資料類型：DATE_TIME。要插入的日期值。
`STRING`	資料類型：STRING。要插入的字串值。

DsaPageFeedCriterionField

動態搜尋廣告網頁動態饋給條件欄位可能的值。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅適用於傳回值。代表此版本中未知的值。
`PAGE_URL`	資料類型：URL 或 URL_LIST。您要指定的網頁網址。
`LABEL`	資料類型：STRING_LIST。標籤可協助您在網頁動態饋給中指定廣告目標。

LocationExtensionTargetingCriterionField

地點額外資訊指定目標條件欄位可能的值。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅適用於傳回值。代表此版本中未知的值。
`ADDRESS_LINE_1`	資料類型：STRING。商家地址的第 1 行。
`ADDRESS_LINE_2`	資料類型：STRING。商家地址的第 2 行。
`CITY`	資料類型：STRING。商家地址的城市。
`PROVINCE`	資料類型：STRING。商家地址的省份。
`POSTAL_CODE`	資料類型：STRING。商家地址的郵遞區號。
`COUNTRY_CODE`	資料類型：STRING。商家地址的國家/地區代碼。

EducationPlaceholderField

可能的 Education 預留位置欄位值。

列舉
`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`	資料類型：URL_LIST。必要欄位。廣告中使用「升級網址」時要使用的最終到達網址，較為明確 (例如特定程式的個別網址和其位置)。
`FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時廣告的最終行動版網址。
`TRACKING_URL`	資料類型：網址。使用升級網址時廣告的追蹤範本。
`CONTEXTUAL_KEYWORDS`	資料類型：STRING_LIST。用於擷取產品的關鍵字。
`ANDROID_APP_LINK`	資料類型：STRING。Android 應用程式連結。格式必須為：android-app://{package_id}/{scheme}/{host_path}。元件定義如下：package_id：Google Play 中指定的應用程式 ID。配置：要傳遞至應用程式的配置。可以是 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，目的地 ID 必須是專屬鍵。如果動態饋給項目同時含有目的地 ID 和起點 ID，該組合必須是專屬鍵。
`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`	資料類型：URL_LIST。必要欄位。使用「升級網址」時的最終到達網址。當使用者點選廣告或點選包含多個檔期的廣告特定檔期時，系統會將他們重新導向至這些網址。
`FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時廣告的最終行動版網址。
`TRACKING_URL`	資料類型：網址。使用升級網址時廣告的追蹤範本。
`ANDROID_APP_LINK`	資料類型：STRING。Android 應用程式連結。格式必須為：android-app://{package_id}/{scheme}/{host_path}。元件定義如下：package_id：Google Play 中指定的應用程式 ID。配置：要傳遞至應用程式的配置。可以是 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。產品或服務的完整地址，包括郵遞區號。如果動態饋給中有多項與使用者相關的產品，系統就會根據這項資訊，向使用者識別最接近使用者的產品。
`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`	資料類型：URL_LIST。使用「升級網址」的廣告最終到達網址。當使用者按下廣告，或是所點擊特定產品的廣告包含多個產品時，系統會將他們重新導向至這些網址。
`FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時廣告的最終行動版網址。
`TRACKING_URL`	資料類型：網址。使用升級網址時廣告的追蹤範本。
`CONTEXTUAL_KEYWORDS`	資料類型：STRING_LIST。用於擷取產品的關鍵字。
`ANDROID_APP_LINK`	資料類型：STRING。Android 應用程式連結。格式必須為：android-app://{package_id}/{scheme}/{host_path}。元件定義如下：package_id：Google Play 中指定的應用程式 ID。配置：要傳遞至應用程式的配置。可以是 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`	資料類型：URL_LIST。必要欄位。使用「升級網址」時的最終到達網址。當使用者點選廣告或點選包含多個檔期的廣告特定檔期時，系統會將他們重新導向至這些網址。
`FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時廣告的最終行動版網址。
`TRACKING_URL`	資料類型：網址。使用升級網址時廣告的追蹤範本。
`ANDROID_APP_LINK`	資料類型：STRING。Android 應用程式連結。格式必須為：android-app://{package_id}/{scheme}/{host_path}。元件定義如下：package_id：Google Play 中指定的應用程式 ID。配置：要傳遞至應用程式的配置。可以是 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`	資料類型：URL_LIST。廣告使用「升級網址」時要使用的最終到達網址，較為明確 (例如特定商家資訊的個別網址及其位置)。
`FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時廣告的最終行動版網址。
`TRACKING_URL`	資料類型：網址。使用升級網址時廣告的追蹤範本。
`ANDROID_APP_LINK`	資料類型：STRING。Android 應用程式連結。格式必須為：android-app://{package_id}/{scheme}/{host_path}。元件定義如下：package_id：Google Play 中指定的應用程式 ID。配置：要傳遞至應用程式的配置。可以是 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，目的地 ID 必須是專屬鍵。如果動態饋給項目同時含有目的地 ID 和起點 ID，該組合必須是專屬鍵。
`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`	資料類型：URL_LIST。必要欄位。廣告中使用的最終到達網址，使用升級網址時越明確越好 (例如特定旅遊優惠的個別網址及其所在位置)。
`FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時廣告的最終行動版網址。
`TRACKING_URL`	資料類型：網址。使用升級網址時廣告的追蹤範本。
`ANDROID_APP_LINK`	資料類型：STRING。Android 應用程式連結。格式必須為：android-app://{package_id}/{scheme}/{host_path}。元件定義如下：package_id：Google Play 中指定的應用程式 ID。配置：要傳遞至應用程式的配置。可以是 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`	資料類型：URL_LIST。必要欄位。使用升級網址時用於廣告中的最終到達網址，較為明確 (例如特定本地優惠的個別網址及其地點)。
`FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時廣告的最終行動版網址。
`TRACKING_URL`	資料類型：網址。使用升級網址時廣告的追蹤範本。
`ANDROID_APP_LINK`	資料類型：STRING。Android 應用程式連結。格式必須為：android-app://{package_id}/{scheme}/{host_path}。元件定義如下：package_id：Google Play 中指定的應用程式 ID。配置：要傳遞至應用程式的配置。可以是 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，則組合不得重複。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`	資料類型：URL_LIST。必要欄位。使用「升級網址」時要用於廣告中的最終到達網址，越明確越好 (例如特定工作的個別網址及其所在位置)。
`FINAL_MOBILE_URLS`	資料類型：URL_LIST。使用升級網址時廣告的最終行動版網址。
`TRACKING_URL`	資料類型：網址。使用升級網址時廣告的追蹤範本。
`ANDROID_APP_LINK`	資料類型：STRING。Android 應用程式連結。格式必須為：android-app://{package_id}/{scheme}/{host_path}。元件定義如下：package_id：Google Play 中指定的應用程式 ID。配置：要傳遞至應用程式的配置。可以是 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

動態饋給對應的狀態。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅適用於傳回值。代表此版本中未知的值。
`ENABLED`	動態饋給對應已啟用。
`REMOVED`	已移除動態饋給對應。

FeedMappingCriterionType

動態饋給對應的可能預留位置類型。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅適用於傳回值。代表此版本中未知的值。
`LOCATION_EXTENSION_TARGETING`	可讓您指定廣告活動在位置動態饋給中的指定位置。
`DSA_PAGE_FEED`	允許在網頁動態饋給中指定動態搜尋廣告的網址。