- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- HotelAssetSuggestion
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- HotelTextAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- HotelImageAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- HotelAssetSuggestionStatus
- Testen!
Gibt Vorschläge für Reise-Assets zurück. Asset-Vorschläge werden bestmöglich 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/v17/customers/{customerId}:suggestTravelAssets
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
customerId |
Erforderlich. Die ID des Kunden. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "languageOption": string, "placeIds": [ string ] } |
Felder | |
---|---|
languageOption |
Erforderlich. Die Sprachspezifikationen im BCP 47-Format (z. B. en-US oder zh-CN) für die Asset-Vorschläge. Text wird in dieser Sprache verfasst. Stimmt normalerweise mit einer der Zielsprachen der Kampagne überein. |
placeIds[] |
Die Google Maps-Orts-IDs von 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 ( |
Felder | |
---|---|
hotelAssetSuggestions[] |
Asset-Vorschläge für jede in der Anfrage eingereichte Orts-ID. |
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 den Asset-Vorschlägen für ein Hotel.
JSON-Darstellung |
---|
{ "placeId": string, "finalUrl": string, "hotelName": string, "callToAction": enum ( |
Felder | |
---|---|
placeId |
Google Places-ID des Hotels. |
finalUrl |
Dies ist die vorgeschlagene finale URL für eine AssetGroup. |
hotelName |
Hotelname in der angeforderten Sprache. |
callToAction |
Typ des Call-to-Action. |
textAssets[] |
Text-Assets wie Anzeigentitel oder Textzeile |
imageAssets[] |
Bild-Assets wie Querformat/Hochformat/Quadratformat usw. |
status |
Der Status des Vorschlags für Hotel-Assets. |
HotelTextAsset
Ein einzelner Vorschlag für Text-Assets für ein Hotel.
JSON-Darstellung |
---|
{
"text": string,
"assetFieldType": enum ( |
Felder | |
---|---|
text |
Asset-Text in der angeforderten Sprache. |
assetFieldType |
Der Typ des Text-Assets. Beispiele: HEADLINE, DESCRIPTION usw. |
HotelImageAsset
Ein einzelnes Bild-Asset-Vorschlag für ein Hotel.
JSON-Darstellung |
---|
{
"uri": string,
"assetFieldType": enum ( |
Felder | |
---|---|
uri |
URI für das Bild. |
assetFieldType |
Der Asset-Typ „Bild“. Beispiele: MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE usw. |
HotelAssetSuggestionStatus
Mögliche Status eines Vorschlags für Hotel-Assets.
Enums | |
---|---|
UNSPECIFIED |
Enum nicht angegeben. |
UNKNOWN |
Der empfangene Fehlercode ist in dieser Version nicht bekannt. |
SUCCESS |
Der Vorschlag für Hotel-Assets wurde abgerufen. |
HOTEL_NOT_FOUND |
Bei einer Hotelsuche wird nichts zurückgegeben. |
INVALID_PLACE_ID |
Eine Google Places-ID ist ungültig und kann nicht decodiert werden. |