Method: customers.suggestTravelAssets

Restituisce suggerimenti sugli asset di viaggio. I suggerimenti relativi agli asset vengono restituiti secondo il criterio del "best effort". Non viene garantito che vengano restituiti tutti i possibili tipi di asset per un determinato hotel.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. L'ID del cliente.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
Campi
languageOption

string

Obbligatorio. Le specifiche della lingua in formato BCP 47 (ad es. en-US, zh-CN e così via) per i suggerimenti sugli asset. Il testo sarà in questa lingua. In genere corrisponde a una delle lingue di destinazione della campagna.
placeIds[]

string

Gli ID luogo di Google Maps degli hotel per i quali sono richieste le risorse. Per saperne di più, visita la pagina https://developers.google.com/places/web-service/place-id.

Corpo della risposta

Messaggio di risposta per TravelAssetSuggestionService.SuggestTravelAssets.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
Campi
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

Suggerimenti di asset per ogni ID luogo inviato nella richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

HotelAssetSuggestion

Messaggio contenente i suggerimenti di asset per un hotel.

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

string

ID Google Places dell'hotel.
finalUrl

string

URL finale suggerito per un gruppo di asset.
hotelName

string

Nome hotel nella lingua richiesta.
callToAction

enum (CallToActionType)

Tipo di invito all'azione.
textAssets[]

object (HotelTextAsset)

Asset di testo come titolo, descrizione e così via
imageAssets[]

object (HotelImageAsset)

Asset immagine, ad esempio orizzontale/verticale/quadrato e così via.
status

enum (HotelAssetSuggestionStatus)

Lo stato del suggerimento per l'asset per hotel.

HotelTextAsset

Un suggerimento per un singolo asset di testo per un hotel.

Rappresentazione JSON 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Campi
text

string

Testo dell'asset nella lingua richiesta.
assetFieldType

enum (AssetFieldType)

Il tipo di asset di testo. Ad esempio, TITOLO, DESCRIZIONE e così via.

HotelImageAsset

Un singolo suggerimento di asset immagine per un hotel.

Rappresentazione JSON 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Campi
uri

string

URI dell'immagine.
assetFieldType

enum (AssetFieldType)

Il tipo di asset immagine. Ad esempio, MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE e così via.

HotelAssetSuggestionStatus

Possibili stati di un suggerimento di asset per hotel.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
SUCCESS Il suggerimento per l'asset per hotel è stato recuperato.
HOTEL_NOT_FOUND La ricerca di un hotel non restituisce nulla.
INVALID_PLACE_ID Un ID Google Places non è valido e non può essere decodificato.