Method: customers.suggestTravelAssets

Muestra sugerencias de recursos de viaje. Las sugerencias de elementos se muestran sobre la base del mejor esfuerzo. No se garantiza que se mostrarán todos los tipos de recursos posibles para una propiedad de hotel determinada.

Solicitud HTTP

POST https://googleads.googleapis.com/v14/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 recursos. El texto estará en este idioma. Generalmente, coincide 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)

Es un 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 recursos de hoteles.

HotelTextAsset

Una sugerencia de recurso de texto único 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 único 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

Posibles estados de una sugerencia de recurso de hotel.

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