- 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
動態饋給對應。
JSON 表示法 |
---|
{ "resourceName": string, "attributeFieldMappings": [ { object ( |
欄位 | |
---|---|
resourceName |
無法變更。動態饋給對應的資源名稱。動態饋給對應資源名稱的格式為:
|
attributeFieldMappings[] |
無法變更。將動態饋給屬性對應至欄位對應。這些對應是一對多關係,意即 1 個動態饋給屬性可用於填入多個預留位置欄位,但 1 個預留位置欄位只能從 1 個動態饋給屬性擷取資料。廣告自訂參數為例外情況,1 個預留位置欄位可對應至多個動態饋給屬性。這是必填欄位。 |
status |
僅供輸出。動態饋給對應狀態。這是唯讀欄位。 |
feed |
無法變更。此動態饋給對應的動態饋給。 |
聯集欄位 target 。動態饋給對應目標。可以是預留位置或條件。針對特定動態饋給,有效的 FeedMappings 必須有不重複的目標。必要欄位。target 只能是下列其中一項: |
|
placeholderType |
無法變更。此對應的預留位置類型 (例如,如果將動態饋給屬性對應至預留位置欄位)。 |
criterionType |
無法變更。此對應的條件類型 (例如,將動態饋給屬性對應至條件欄位)。 |
AttributeFieldMapping
將動態饋給屬性 ID 對應至預留位置或條件欄位 ID。
JSON 表示法 |
---|
{ "feedAttributeId": string, "fieldId": string, // Union field |
欄位 | |
---|---|
feedAttributeId |
無法變更。要對應的動態饋給屬性。 |
fieldId |
僅供輸出。預留位置欄位 ID。如果目前 API 版本中沒有發布預留位置欄位列舉,系統會填入這個欄位,其中一個欄位將留空。這是唯讀欄位。 |
聯集欄位 field 。使用上述動態饋給屬性資料填入的預留位置或條件欄位。必要欄位。field 只能是下列其中一項: |
|
sitelinkField |
無法變更。網站連結預留位置欄位。 |
callField |
無法變更。呼叫預留位置欄位。 |
appField |
無法變更。應用程式預留位置欄位。 |
locationField |
僅供輸出。位置預留位置欄位。這是唯讀欄位。 |
affiliateLocationField |
僅供輸出。經銷地點預留位置欄位。這是唯讀欄位。 |
calloutField |
無法變更。呼叫預留位置欄位。 |
structuredSnippetField |
無法變更。網站簡介預留位置欄位。 |
messageField |
無法變更。訊息預留位置欄位。 |
priceField |
無法變更。價格預留位置欄位。 |
promotionField |
無法變更。促銷活動預留位置欄位。 |
adCustomizerField |
無法變更。廣告自訂參數預留位置欄位 |
dsaPageFeedField |
無法變更。動態搜尋廣告網頁動態饋給欄位。 |
locationExtensionTargetingField |
無法變更。指定地區欄位。 |
educationField |
無法變更。教育預留位置欄位 |
flightField |
無法變更。航班預留位置欄位 |
customField |
無法變更。自訂預留位置欄位 |
hotelField |
無法變更。飯店預留位置欄位 |
realEstateField |
無法變更。房地產預留位置欄位 |
travelField |
無法變更。旅遊預留位置欄位 |
localField |
無法變更。本機預留位置欄位 |
jobField |
無法變更。工作預留位置欄位 |
imageField |
無法變更。圖片預留位置欄位 |
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 |
允許在網頁動態饋給中指定動態搜尋廣告的網址。 |