Method: customers.suggestTravelAssets

傳回 Travel Asset 項建議。系統會盡可能傳回素材資源建議。我們不保證會針對指定飯店房源傳回所有可能的素材資源類型。

HTTP 要求

POST https://googleads.googleapis.com/v14/customers/{customerId}:suggestTravelAssets

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。客戶的 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
欄位
languageOption

string

必要欄位。素材資源建議的語言規格，採用 BCP 47 格式 (例如 en-US、zh-CN 等)。文字將以此語言顯示。通常與其中一個廣告活動指定語言相符。
placeIds[]

string

要求資產的飯店 Google 地圖地點 ID。詳情請參閱 https://developers.google.com/places/web-service/place-id。

回應主體

TravelAssetSuggestionService.SuggestTravelAssets 的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
欄位
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

針對要求中提交的各個地點 ID 提供素材資源建議。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽。

HotelAssetSuggestion

包含飯店素材資源建議的訊息。

JSON 表示法 
{
  "placeId": string,
  "finalUrl": string,
  "hotelName": string,
  "callToAction": enum (CallToActionType),
  "textAssets": [
    {
      object (HotelTextAsset)
    }
  ],
  "imageAssets": [
    {
      object (HotelImageAsset)
    }
  ],
  "status": enum (HotelAssetSuggestionStatus)
}
欄位
placeId

string

飯店的 Google 地點 ID，
finalUrl

string

AssetGroup 的建議最終到達網址。
hotelName

string

飯店名稱以要求的語言呈現。
callToAction

enum (CallToActionType)

行動號召類型。
textAssets[]

object (HotelTextAsset)

文字素材資源，例如標題、說明等。
imageAssets[]

object (HotelImageAsset)

圖片素材資源，例如橫向/直向/正方形等。
status

enum (HotelAssetSuggestionStatus)

飯店素材資源建議的狀態。

HotelTextAsset

飯店的單一文字素材資源建議。

JSON 表示法 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
欄位
text

string

素材資源文字，以要求的語言呈現。
assetFieldType

enum (AssetFieldType)

文字素材資源類型。例如 HEADLINE、DESCRIPTION 等。

HotelImageAsset

飯店的單一圖片素材資源建議。

JSON 表示法 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
欄位
uri

string

圖片的 URI。
assetFieldType

enum (AssetFieldType)

圖片素材資源類型。例如 MARKETING_IMAGE、PORTRAIT_MARKETING_IMAGE 等。

HotelAssetSuggestionStatus

飯店素材資源建議的可能狀態。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
SUCCESS 已成功擷取飯店素材資源建議。
HOTEL_NOT_FOUND 飯店查詢不會傳回任何結果。
INVALID_PLACE_ID Google Places ID 無效，無法解碼。