Method: customers.suggestTravelAssets

Retorna sugestões de recursos de viagem. As sugestões de recursos são retornadas na medida do possível. Não há garantias de que todos os tipos de recurso possíveis vão ser retornados para qualquer propriedade do hotel.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
Campos
languageOption

string

Obrigatório. As especificações de idioma no formato BCP 47 (por exemplo, en-US, zh-CN etc.) para as sugestões de recursos. O texto estará neste idioma. Geralmente corresponde a um dos idiomas de segmentação da campanha.
placeIds[]

string

Os IDs de lugares do Google Maps dos hotéis para os quais os recursos são solicitados. Consulte https://developers.google.com/places/web-service/place-id para mais informações.

Corpo da resposta

Mensagem de resposta para TravelAssetSuggestionService.SuggestTravelAssets.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
Campos
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

Sugestões de recursos para cada ID de local enviado na solicitação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

HotelAssetSuggestion

Mensagem com as sugestões de recursos para um hotel.

Representação JSON 
{
  "placeId": string,
  "finalUrl": string,
  "hotelName": string,
  "callToAction": enum (CallToActionType),
  "textAssets": [
    {
      object (HotelTextAsset)
    }
  ],
  "imageAssets": [
    {
      object (HotelImageAsset)
    }
  ],
  "status": enum (HotelAssetSuggestionStatus)
}
Campos
placeId

string

ID do Google Places do hotel.
finalUrl

string

URL final sugerido para um AssetGroup.
hotelName

string

Nome do hotel no idioma solicitado.
callToAction

enum (CallToActionType)

Tipo de call-to-action.
textAssets[]

object (HotelTextAsset)

Recursos de texto, como título, descrição etc.
imageAssets[]

object (HotelImageAsset)

Recursos de imagem como paisagem/retrato/quadrado etc.
status

enum (HotelAssetSuggestionStatus)

O status da sugestão do recurso de hotel.

HotelTextAsset

Uma única sugestão de recurso de texto para um hotel.

Representação JSON 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Campos
text

string

Texto do recurso no idioma solicitado.
assetFieldType

enum (AssetFieldType)

O tipo de recurso de texto. Por exemplo, TÍTULO, DESCRIÇÃO etc.

HotelImageAsset

Uma sugestão de recurso de imagem única para um hotel.

Representação JSON 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Campos
uri

string

URI para a imagem.
assetFieldType

enum (AssetFieldType)

O tipo de recurso de imagem. Por exemplo, MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE etc.

HotelAssetSuggestionStatus

Status possíveis de uma sugestão de recurso de hotel.

Enums
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
SUCCESS A sugestão de recurso de hotel foi recuperada.
HOTEL_NOT_FOUND Uma pesquisa de hotel não retorna nada.
INVALID_PLACE_ID O ID do Google Places é inválido e não pode ser decodificado.