Method: customers.suggestTravelAssets

Affiche des suggestions d'assets Voyage. Les suggestions d'assets sont renvoyées dans la mesure du possible. Rien ne garantit que tous les types de composants possibles seront renvoyés pour un établissement hôtelier donné.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
Champs
languageOption

string

Obligatoire. Spécifications de langue au format BCP 47 (par exemple, en-US, zh-CN, etc.) pour les suggestions d'assets. Le texte sera dans cette langue. Correspond généralement à l'une des langues cibles de la campagne.
placeIds[]

string

ID de lieu Google Maps des hôtels pour lesquels des composants sont demandés. Pour en savoir plus, consultez la page https://developers.google.com/places/web-service/place-id.

Corps de la réponse

Message de réponse pour TravelAssetSuggestionService.SuggestTravelAssets.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
Champs
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

Suggestions d'assets pour chaque ID de lieu envoyé dans la requête.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

HotelAssetSuggestion

Message contenant les suggestions de composants pour un hôtel.

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

string

ID Google Adresses de l'hôtel.
finalUrl

string

URL finale suggérée pour un AssetGroup.
hotelName

string

Nom de l'hôtel dans la langue demandée.
callToAction

enum (CallToActionType)

Type d'incitation à l'action
textAssets[]

object (HotelTextAsset)

Assets texte tels qu'un titre, une description, etc.
imageAssets[]

object (HotelImageAsset)

Assets image (paysage/portrait/carré, etc.)
status

enum (HotelAssetSuggestionStatus)

État de la suggestion de composant Hôtel.

HotelTextAsset

Suggestion d'asset texte unique pour un hôtel.

Représentation JSON 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Champs
text

string

Texte du composant dans la langue demandée.
assetFieldType

enum (AssetFieldType)

Type de composant texte. Exemples : TITRE, DESCRIPTION, etc.

HotelImageAsset

Suggestion de composant Image unique pour un hôtel.

Représentation JSON 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Champs
uri

string

URI de l'image.
assetFieldType

enum (AssetFieldType)

Type de composant Image. Exemples : MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE, etc.

HotelAssetSuggestionStatus

États possibles d'une suggestion de composant Hôtel.

Enums
UNSPECIFIED Énumération non spécifiée.
UNKNOWN Le code d'erreur reçu n'est pas connu dans cette version.
SUCCESS La suggestion de composants Hôtel a bien été récupérée.
HOTEL_NOT_FOUND Une recherche d'hôtel ne renvoie rien.
INVALID_PLACE_ID Un ID Google Places n'est pas valide et ne peut pas être décodé.