Method: customers.suggestTravelAssets

Gibt Vorschläge für Reise-Assets zurück Asset-Vorschläge werden auf Best-Effort-Basis zurückgegeben. Es gibt keine Garantie, dass alle möglichen Asset-Typen für eine bestimmte Hotelunterkunft zurückgegeben werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
customerId

string

Erforderlich. Die ID des Kunden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
Felder
languageOption

string

Erforderlich. Die Sprachangaben im BCP-47-Format (z. B. en-US, zh-CN) für die Asset-Vorschläge. Der Text wird in dieser Sprache angezeigt. Stimmt normalerweise mit einer der Zielsprachen der Kampagne überein.
placeIds[]

string

Die Google Maps-Orts-IDs der Hotels, für die Assets angefordert werden. Weitere Informationen finden Sie unter https://developers.google.com/places/web-service/place-id.

Antworttext

Antwortnachricht für TravelAssetSuggestionService.SuggestTravelAssets.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
Felder
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

Asset-Vorschläge für jede Orts-ID, die in der Anfrage eingereicht wurde

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

HotelAssetSuggestion

Nachricht mit Asset-Vorschlägen für ein Hotel.

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

string

Google Places-ID des Hotels
finalUrl

string

Vorgeschlagene finale URL für eine Asset-Gruppe.
hotelName

string

Hotelname in der angeforderten Sprache.
callToAction

enum (CallToActionType)

Call-to-Action-Typ.
textAssets[]

object (HotelTextAsset)

Text-Assets, z. B. Anzeigentitel und Textzeilen
imageAssets[]

object (HotelImageAsset)

Bild-Assets, z. B. Querformat/Hochformat/Quadrat usw.
status

enum (HotelAssetSuggestionStatus)

Der Status des Vorschlags für Hotel-Assets.

HotelTextAsset

Ein einzelner Vorschlag für ein Text-Asset für ein Hotel.

JSON-Darstellung 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Felder
text

string

Asset-Text in der angeforderten Sprache.
assetFieldType

enum (AssetFieldType)

Der Typ „Text-Asset“. Zum Beispiel HEADLINE, DESCRIPTION usw.

HotelImageAsset

Ein Vorschlag für ein einzelnes Bild-Asset für ein Hotel.

JSON-Darstellung 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Felder
uri

string

URI für das Bild.
assetFieldType

enum (AssetFieldType)

Asset-Typ „Bild“ Zum Beispiel MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE usw.

HotelAssetSuggestionStatus

Mögliche Status eines Hotel-Asset-Vorschlags.

Enums
UNSPECIFIED Enum nicht angegeben.
UNKNOWN Der empfangene Fehlercode ist in dieser Version nicht bekannt.
SUCCESS Der Vorschlag für das Hotel-Asset wurde abgerufen.
HOTEL_NOT_FOUND Eine Hotelsuche liefert keine Ergebnisse.
INVALID_PLACE_ID Eine Google Places-ID ist ungültig und kann nicht decodiert werden.