Method: customers.suggestTravelAssets

Muestra sugerencias de recursos de viaje. Las sugerencias de recursos se muestran según el criterio del mejor esfuerzo. No hay garantía de que se muestren todos los tipos de recursos posibles para una propiedad de hotel determinada.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. El ID del cliente.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
Campos
languageOption

string

Obligatorio. Las especificaciones de idioma en formato BCP 47 (por ejemplo, en-US, zh-CN, etc.) para las sugerencias de elementos. El texto estará en este idioma. Suele coincidir con uno de los idiomas de segmentación de la campaña.
placeIds[]

string

Son los IDs de lugar de Google Maps de los hoteles para los que se solicitan recursos. Consulta https://developers.google.com/places/web-service/place-id para obtener más información.

Cuerpo de la respuesta

Mensaje de respuesta para TravelAssetSuggestionService.SuggestTravelAssets.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
Campos
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

Sugerencias de recursos para cada ID de lugar enviado en la solicitud.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

HotelAssetSuggestion

Es un mensaje que contiene las sugerencias de recursos para un hotel.

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

string

Es el ID de Google Places del hotel.
finalUrl

string

URL final sugerida para un AssetGroup.
hotelName

string

Nombre del hotel en el idioma solicitado.
callToAction

enum (CallToActionType)

Tipo de llamado a la acción.
textAssets[]

object (HotelTextAsset)

Recursos de texto, como el título, la descripción, etcétera
imageAssets[]

object (HotelImageAsset)

Recursos de imagen, como horizontal, vertical, cuadrado, etcétera
status

enum (HotelAssetSuggestionStatus)

El estado de la sugerencia de recurso de hotel.

HotelTextAsset

Una sola sugerencia de recurso de texto para un hotel.

Representación JSON 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Campos
text

string

Texto del recurso en el idioma solicitado.
assetFieldType

enum (AssetFieldType)

Es el tipo de recurso de texto. Por ejemplo, HEADLINE, DESCRIPTION, etcétera

HotelImageAsset

Una sugerencia de recurso de imagen única para un hotel.

Representación JSON 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Campos
uri

string

Es el URI de la imagen.
assetFieldType

enum (AssetFieldType)

Es el tipo de recurso de imagen. Por ejemplo, MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE, etc.

HotelAssetSuggestionStatus

Estados posibles de una sugerencia de recurso de hotel.

Enumeradores
UNSPECIFIED Enumeración sin especificar.
UNKNOWN En esta versión no se conoce el código de error que se recibió.
SUCCESS Se recuperó correctamente la sugerencia de recurso de hotel.
HOTEL_NOT_FOUND Una búsqueda de hotel no devuelve nada.
INVALID_PLACE_ID Un ID de Google Places no es válido y no se puede decodificar.