- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- HotelAssetSuggestion
- HotelTextAsset
- HotelImageAsset
- HotelAssetSuggestionStatus
- Faça um teste
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 |
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 |
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[] |
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 ( |
Campos | |
---|---|
hotelAssetSuggestions[] |
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 ( |
Campos | |
---|---|
placeId |
ID do hotel no Google Places. |
finalUrl |
URL final sugerido para um AssetGroup. |
hotelName |
Nome do hotel no idioma solicitado. |
callToAction |
Tipo de call-to-action. |
textAssets[] |
Recursos de texto, como título, descrição etc. |
imageAssets[] |
Recursos de imagem, como paisagem/retrato/quadrado etc. |
status |
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 ( |
Campos | |
---|---|
text |
Texto do recurso no idioma solicitado. |
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 ( |
Campos | |
---|---|
uri |
URI para a imagem. |
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. |