- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- HotelAssetSuggestion
- HotelTextAsset
- HotelImageAsset
- HotelAssetSuggestionStatus
- Wypróbuj
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/v15/customers/{customerId}:suggestTravelAssets
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
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 |
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[] |
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 ( |
Pola | |
---|---|
hotelAssetSuggestions[] |
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 ( |
Pola | |
---|---|
placeId |
Identyfikator hotelu w usłudze Miejsca Google. |
finalUrl |
Sugerowany końcowy adres URL dla grupy komponentów. |
hotelName |
Nazwa hotelu w wybranym języku. |
callToAction |
Typ wezwania do działania. |
textAssets[] |
Komponenty tekstowe, takie jak nagłówek, tekst reklamy itp. |
imageAssets[] |
Zasoby graficzne, np. poziomy/pionowa/kwadratowa |
status |
Stan sugestii komponentu dotyczącego hotelu. |
HotelTextAsset
Jedna sugestia komponentu tekstowego dla hotelu.
Zapis JSON |
---|
{
"text": string,
"assetFieldType": enum ( |
Pola | |
---|---|
text |
Tekst zasobu w wybranym języku. |
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 ( |
Pola | |
---|---|
uri |
Identyfikator URI obrazu. |
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ć. |