- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- HotelAssetSuggestion
- HotelTextAsset
- HotelImageAsset
- HotelAssetSuggestionStatus
- Wypróbuj
Zwraca sugestie dotyczące komponentów związanych z podróżami. Sugestie komponentów są wyświetlane zgodnie z zasadą możliwie najlepszej obsługi. Nie ma gwarancji, że w przypadku danego obiektu hotelowego zostaną zwrócone wszystkie możliwe typy komponentów.
Żądanie HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}:suggestTravelAssets
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
Wymagane. Identyfikator klienta. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "languageOption": string, "placeIds": [ string ] } |
Pola | |
---|---|
languageOption |
Wymagane. Specyfikacja języka w formacie BCP 47 (np. en-US, zh-CN itp.) na potrzeby propozycji komponentów. Tekst będzie w tym języku. Zwykle pasuje do jednego z języków docelowych kampanii. |
placeIds[] |
Identyfikatory miejsc w Mapach Google hoteli, których dotyczy żądanie komponentów. Więcej informacji znajdziesz na stronie https://developers.google.com/places/web-service/place-id. |
Treść odpowiedzi
Wiadomość z odpowiedzią dla: TravelAssetSuggestionService.SuggestTravelAssets
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"hotelAssetSuggestions": [
{
object ( |
Pola | |
---|---|
hotelAssetSuggestions[] |
Sugestie 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ść zawierająca sugestie dotyczące komponentów dla hotelu.
Zapis JSON |
---|
{ "placeId": string, "finalUrl": string, "hotelName": string, "callToAction": enum ( |
Pola | |
---|---|
placeId |
Identyfikator hotelu w Miejscach Google. |
finalUrl |
Sugerowany końcowy adres URL grupy komponentów. |
hotelName |
Nazwa hotelu w wybranym języku. |
callToAction |
Typ wezwania do działania. |
textAssets[] |
Komponenty tekstowe, np. nagłówek, tekst reklamy itp. |
imageAssets[] |
Komponenty z obrazem, np. w orientacji poziomej lub pionowej albo w formacie kwadratowym. |
status |
Stan sugestii komponentu z hotelem. |
HotelTextAsset
Pojedyncza sugestia komponentu tekstowego dla hotelu.
Zapis JSON |
---|
{
"text": string,
"assetFieldType": enum ( |
Pola | |
---|---|
text |
Tekst komponentu w wybranym języku. |
assetFieldType |
Typ komponentu tekstowego. Na przykład HEADLINE, DESCRIPTION itp. |
HotelImageAsset
Sugestia komponentu z jednym obrazem dla 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 z hotelem.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Wyliczenie nieokreślone. |
UNKNOWN |
Otrzymany kod błędu nie jest znany w tej wersji. |
SUCCESS |
Sugestia komponentu z hotelem została pobrana. |
HOTEL_NOT_FOUND |
Wyszukiwanie hotelu nie zwraca żadnych wyników. |
INVALID_PLACE_ID |
Identyfikator Miejsc Google jest nieprawidłowy i nie można go zdekodować. |