Method: customers.suggestTravelAssets

Zwraca sugestie komponentów dotyczących podróży. Sugestie dotyczące zasobów są zwracane zgodnie z zasadą możliwie najlepszej obsługi. Nie możemy zagwarantować, że w przypadku danego obiektu hotelowego zostaną zwrócone wszystkie możliwe typy komponentów.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
Pola
languageOption

string

To pole jest wymagane. Specyfikacje języka w formacie BCP 47 (np. en-US, zh-CN itp.) w sugestiach dotyczących zasobów. Tekst będzie w tym języku. Zwykle odpowiada jednemu z języków docelowych kampanii.
placeIds[]

string

identyfikatory miejsc w Mapach Google hoteli, w przypadku których wysłano prośbę o zasoby; Więcej informacji znajdziesz na stronie https://developers.google.com/places/web-service/place-id.

Treść odpowiedzi

Odpowiedź na pytanie: TravelAssetSuggestionService.SuggestTravelAssets.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
Pola
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

Sugestie dotyczące zasobów dla każdego identyfikatora miejsca przesłanego w prośbie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

HotelAssetSuggestion

Wiadomość zawierająca sugestie dotyczące komponentów dotyczące hotelu.

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

string

Identyfikator hotelu w usłudze Miejsca Google.
finalUrl

string

Sugerowany końcowy adres URL dla grupy komponentów.
hotelName

string

Nazwa hotelu w wybranym języku.
callToAction

enum (CallToActionType)

Typ wezwania do działania.
textAssets[]

object (HotelTextAsset)

Komponenty tekstowe, takie jak nagłówek, tekst reklamy itp.
imageAssets[]

object (HotelImageAsset)

Komponenty z obrazem, np. obraz w orientacji poziomej/pionowej/kwadratowej.
status

enum (HotelAssetSuggestionStatus)

Stan sugestii komponentu dotyczącego hotelu.

HotelTextAsset

Jedna sugestia komponentu tekstowego dla hotelu.

Zapis JSON 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Pola
text

string

Tekst zasobu w wybranym języku.
assetFieldType

enum (AssetFieldType)

Typ komponentu tekstowego. Na przykład HEADLINE, DESCRIPTION itd.

HotelImageAsset

Sugestia dotycząca pojedynczego komponentu z obrazem dla hotelu.

Zapis JSON 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Pola
uri

string

Identyfikator URI obrazu.
assetFieldType

enum (AssetFieldType)

Typ komponentu z obrazem. Na przykład MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE itp.

HotelAssetSuggestionStatus

Możliwe stany sugestii komponentu dotyczącego hotelu.

Wartości w polu enum
UNSPECIFIED Wyliczenie nieokreślone.
UNKNOWN Otrzymany kod błędu jest nieznany w tej wersji.
SUCCESS Sugestia dotycząca komponentu dotyczącego hotelu została pobrana.
HOTEL_NOT_FOUND Wyszukiwanie hoteli nie zwraca niczego.
INVALID_PLACE_ID Identyfikator Miejsc Google jest nieprawidłowy i nie można go zdekodować.