Method: customers.suggestTravelAssets

Restituisce suggerimenti sugli asset di viaggio. I suggerimenti sugli asset vengono restituiti secondo il criterio del "best effort". Non vi è alcuna garanzia che tutti i possibili tipi di asset verranno restituiti per una determinata proprietà di hotel.

Richiesta HTTP

POST https://googleads.googleapis.com/v16/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 esempio 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 vengono 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 sugli 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 pagina Panoramica di OAuth 2.0.

HotelAssetSuggestion

Messaggio contenente i suggerimenti sugli 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 consigliato per un gruppo di asset.
hotelName

string

Nome dell'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 sugli asset per hotel.

HotelTextAsset

Un singolo suggerimento relativo a un 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 per un 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 relativo all'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.