- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- HotelAssetSuggestion
- HotelTextAsset
- HotelImageAsset
- HotelAssetSuggestionStatus
- Prova!
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/v15/customers/{customerId}:suggestTravelAssets
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
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 |
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[] |
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 ( |
Campi | |
---|---|
hotelAssetSuggestions[] |
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 ( |
Campi | |
---|---|
placeId |
ID Google Places dell'hotel. |
finalUrl |
URL finale suggerito per un gruppo di asset. |
hotelName |
Nome hotel nella lingua richiesta. |
callToAction |
Tipo di invito all'azione. |
textAssets[] |
Asset di testo come titolo, descrizione e così via |
imageAssets[] |
Asset immagine, ad esempio orizzontale/verticale/quadrato e così via. |
status |
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 ( |
Campi | |
---|---|
text |
Testo dell'asset nella lingua richiesta. |
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 ( |
Campi | |
---|---|
uri |
URI dell'immagine. |
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. |