Method: customers.suggestTravelAssets

Affiche des suggestions de composants 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/v16/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 rédigé 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 demande.

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 des 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 élément AssetGroup.
hotelName

string

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

enum (CallToActionType)

Type d'incitation à l'action.
textAssets[]

object (HotelTextAsset)

Composants texte comme un titre, une description, etc.
imageAssets[]

object (HotelImageAsset)

Composants Image (paysage/portrait/carré, etc.)
status

enum (HotelAssetSuggestionStatus)

État de la suggestion de composant Hôtel.

HotelTextAsset

Suggestion de composant texte unique pour un hôtel.

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

string

Texte de l'asset dans la langue demandée.
assetFieldType

enum (AssetFieldType)

Type de composant texte. Par exemple : 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. Par exemple : MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE, etc.

HotelAssetSuggestionStatus

États possibles d'une suggestion de composants pour hôtel.

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