Method: customers.suggestTravelAssets

Zwraca sugestie dotyczące 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/v14/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. Specyfikacja 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, na które kierowana jest kampania.
placeIds[]

string

Identyfikatory miejsc w Mapach Google hoteli, których dotyczy prośba o zasób. Więcej informacji znajdziesz na stronie https://developers.google.com/places/web-service/place-id.

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: 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 komponentów do 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 artykule Omówienie protokołu OAuth 2.0.

HotelAssetSuggestion

Wiadomość z sugestiami dotyczącymi komponentów dotyczącymi 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)

Zasoby graficzne, np. poziomy/pionowa/kwadratowa
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 Nagłówek, DESCRIPTION itp.

HotelImageAsset

Sugestia jednego komponentu z obrazem dotycząca 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 hotelowego.

Wartości w polu enum
UNSPECIFIED Wartość nieokreślona.
UNKNOWN Otrzymany kod błędu jest nieznany w tej wersji.
SUCCESS Sugestia dotycząca komponentu z hotelem została pobrana.
HOTEL_NOT_FOUND Wyszukiwanie hoteli nie zwróciło niczego.
INVALID_PLACE_ID Identyfikator Miejsc Google jest nieprawidłowy i nie można go dekodować.