Method: customers.suggestTravelAssets

Retorna sugestões de recursos de viagem. As sugestões de recursos são retornadas da melhor maneira possível. Não há garantias de que todos os tipos de recursos possíveis sejam retornados para qualquer propriedade de hotel.

Solicitação HTTP

POST https://googleads.googleapis.com/v16/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 lugar do Google Maps de 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 lugar 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 contendo 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 hotel no Google Places.

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 de 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 única sugestão de recurso de imagem 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

Possíveis status 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 hotéis não retorna nada.
INVALID_PLACE_ID Um ID do Google Places é inválido e não pode ser decodificado.