Method: customers.suggestTravelAssets

旅行アセットの候補を返します。アセットの候補はベスト エフォート ベースで返されます。特定のホテル物件について、考え得るすべてのアセットタイプが返されるという保証はありません。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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

アセット グループの最終ページ URL の候補。
hotelName

string

リクエストされた言語でのホテル名。
callToAction

enum (CallToActionType)

行動を促すフレーズのタイプ。
textAssets[]

object (HotelTextAsset)

広告見出しや説明文などのテキスト アセット
imageAssets[]

object (HotelImageAsset)

横向き、縦向き、スクエアなどの画像アセット
status

enum (HotelAssetSuggestionStatus)

ホテルアセットの提案のステータス。

HotelTextAsset

ホテルに関する 1 つのテキスト アセットの提案。

JSON 表現 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
フィールド
text

string

リクエストされた言語でのアセット テキスト。
assetFieldType

enum (AssetFieldType)

テキスト アセットのタイプ。（例: HEADLINE、DESCRIPTION など）。

HotelImageAsset

ホテルに関する 1 つの画像アセットの提案です。

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 プレイス ID が無効なため、デコードできません。