Method: customers.suggestTravelAssets

Returns Travel Asset suggestions. Asset suggestions are returned on a best-effort basis. There are no guarantees that all possible asset types will be returned for any given hotel property.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customerId

string

Required. The ID of the customer.

Request body

The request body contains data with the following structure:

JSON representation
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
Fields
languageOption

string

Required. The language specifications in BCP 47 format (for example, en-US, zh-CN, etc.) for the asset suggestions. Text will be in this language. Usually matches one of the campaign target languages.

placeIds[]

string

The Google Maps Place IDs of hotels for which assets are requested. See https://developers.google.com/places/web-service/place-id for more information.

Response body

Response message for TravelAssetSuggestionService.SuggestTravelAssets.

If successful, the response body contains data with the following structure:

JSON representation
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
Fields
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

Asset suggestions for each place ID submitted in the request.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

HotelAssetSuggestion

Message containing the asset suggestions for a hotel.

JSON representation
{
  "placeId": string,
  "finalUrl": string,
  "hotelName": string,
  "callToAction": enum (CallToActionType),
  "textAssets": [
    {
      object (HotelTextAsset)
    }
  ],
  "imageAssets": [
    {
      object (HotelImageAsset)
    }
  ],
  "status": enum (HotelAssetSuggestionStatus)
}
Fields
placeId

string

Google Places ID of the hotel.

finalUrl

string

Suggested final URL for an AssetGroup.

hotelName

string

Hotel name in requested language.

callToAction

enum (CallToActionType)

Call to action type.

textAssets[]

object (HotelTextAsset)

Text assets such as headline, description, etc.

imageAssets[]

object (HotelImageAsset)

Image assets such as landscape/portrait/square, etc.

status

enum (HotelAssetSuggestionStatus)

The status of the hotel asset suggestion.

HotelTextAsset

A single text asset suggestion for a hotel.

JSON representation
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Fields
text

string

Asset text in requested language.

assetFieldType

enum (AssetFieldType)

The text asset type. For example, HEADLINE, DESCRIPTION, etc.

HotelImageAsset

A single image asset suggestion for a hotel.

JSON representation
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Fields
uri

string

URI for the image.

assetFieldType

enum (AssetFieldType)

The Image asset type. For example, MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE, etc.

HotelAssetSuggestionStatus

Possible statuses of a hotel asset suggestion.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
SUCCESS The hotel asset suggestion was successfully retrieved.
HOTEL_NOT_FOUND A hotel look up returns nothing.
INVALID_PLACE_ID A Google Places ID is invalid and cannot be decoded.