Method: customers.suggestTravelAssets

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

HTTP リクエスト

POST https://googleads.googleapis.com/v14/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 が無効であり、デコードできません。