- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Property PerformanceResult
- Rezerwacja z wyprzedzeniem
- Długość pobytu
- Obecność
Umożliwiają pobieranie (pobieranie, filtrowanie i segmentowanie) raportu o skuteczności usług dotyczących określonego konta.
Żądanie HTTP
GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/propertyPerformanceReportViews:query
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
name |
Nazwa zasobu konta, którego dotyczy zapytanie. Format: konta/{identyfikator_konta} |
Parametry zapytania
Parametry | |
---|---|
filter |
Warunki (pola i wyrażenia) używane do filtrowania danych o skuteczności konta, którego dotyczy zapytanie. Składnia wymaga spacji wokół operatora Pole Wartości w polu W wartościach Przykłady prawidłowych warunków:
|
aggregateBy |
Określa sposób podziału danych zwracanych przez zapytanie. Jeśli na przykład wartość Wartość ciągu znaków to rozdzielona przecinkami lista pól. Prawidłowe pola to: |
pageSize |
Maksymalna liczba wyników uczestnictwa, które zostaną zwrócone. Usługa może zwracać mniejszą wartość. Jeśli nie określono inaczej, zostanie zwróconych maksymalnie 10 000 wyników. Maksymalna wartość wynosi 10 000, a wartości powyżej 10 000 zostaną zmodyfikowane do 10 000. |
pageToken |
Token strony otrzymany z poprzedniego żądania uczestnictwa ReportReports.query. Podaj go, żeby wyświetlić następną stronę. W podziale na strony wszystkie inne parametry podane w polu engagementReportViews.query muszą być zgodne z wywołaniem dostarczonym przez token strony. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Odpowiedź na: PropertyPerformanceReportService.QueryPropertyPerformanceReport
.
Zapis JSON |
---|
{
"results": [
{
object ( |
Pola | |
---|---|
results[] |
Lista wyników pasujących do zapytania. |
nextPageToken |
Token podziału na strony służący do pobierania następnej strony wyników. Jeśli pominiesz to pole, nie będzie kolejnych stron. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/travelpartner
Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.
Wynik wydajności
Reprezentuje wynik zapytania o raport skuteczności konta.
Zapis JSON |
---|
{ "date": { object ( |
Pola | |
---|---|
date |
Data w wybranym zakresie dat. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
advanceBookingWindow |
Różnica w dniach między datą zapytania a datą zameldowania w lokalnej strefie czasowej usługi. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
brand |
Marka określona przez partnera dla właściwości. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
deviceType |
Typ urządzenia użytkownika. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
highIntentUsers |
Czy zapytanie użytkownika wykazało duże zainteresowanie rezerwacją. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
lengthOfStay |
Liczba nocy między datami zameldowania i wymeldowania określonymi przez użytkownika. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
propertyRegionCode |
Kod regionu kraju/regionu podany w normie ISO 3116. Występuje tylko w przypadku, gdy w żądaniu określono właściwość |
occupancy |
Wymagana liczba osób przebywających w hotelu. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
partnerPropertyId |
Identyfikator usługi partnera. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
partnerPropertyDisplayName |
Nazwa właściwości partnera. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
userRegionCode |
Kod regionu zgodny ze standardem ISO 3116 kraju. Występuje tylko w przypadku, gdy w żądaniu określono właściwość |
clickCount |
Łączna liczba kliknięć zarejestrowanych dla tego wyniku. |
impressionCount |
Łączna liczba wyświetleń zarejestrowanych dla tego wyniku. Ta wartość jest zaokrąglana w celu zachowania prywatności użytkownika. |
clickthroughRate |
Kwota |
Rezerwacja z wyprzedzeniem
Określa obsługiwane okresy rezerwacji z wyprzedzeniem (ABW). Wszystkie porównania dat znajdują się w strefie czasowej usługi.
Wartości w polu enum | |
---|---|
ADVANCE_BOOKING_WINDOW_UNSPECIFIED |
Nie określono. |
ADVANCE_BOOKING_WINDOW_SAME_DAY |
Data zameldowania była taka sama jak data zapytania. |
ADVANCE_BOOKING_WINDOW_NEXT_DAY |
Data zameldowania przypadała następnego dnia po dacie zapytania. |
ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7 |
Data zameldowania minęła 2–7 dni od daty zapytania. |
ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14 |
Data zameldowania to 8–14 dni od daty zapytania. |
ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30 |
Data zameldowania minęła 15–30 dni od daty zapytania. |
ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60 |
Data zameldowania to 31–60 dni od daty zapytania. |
ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90 |
Data zameldowania to 61–90 dni po dacie zapytania. |
ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120 |
Data zameldowania to 91–120 dni od daty zapytania. |
ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150 |
Data zameldowania minęła 121–150 dni od daty zapytania. |
ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180 |
Data zameldowania minęła 151-180 dni od daty zapytania. |
ADVANCE_BOOKING_WINDOW_DAYS_OVER_180 |
Data zameldowania minęła ponad 180 dni od daty zapytania. |
Długość pobytu
Określa obsługiwaną długość pobytu (LOS).
Wartości w polu enum | |
---|---|
LENGTH_OF_STAY_UNSPECIFIED |
Nie określono. |
LENGTH_OF_STAY_NIGHTS_1 |
Pobyt na 1 noc. |
LENGTH_OF_STAY_NIGHTS_2 |
Pobyt na 2 noce. |
LENGTH_OF_STAY_NIGHTS_3 |
Pobyt na 3 noce. |
LENGTH_OF_STAY_NIGHTS_4_TO_7 |
Pobyt 4–7 nocy. |
LENGTH_OF_STAY_NIGHTS_8_TO_14 |
Pobyt na 8–14 nocy. |
LENGTH_OF_STAY_NIGHTS_15_TO_21 |
15–21 nocy. |
LENGTH_OF_STAY_NIGHTS_22_TO_30 |
Pobyt 22–30 nocy. |
LENGTH_OF_STAY_NIGHTS_OVER_30 |
Pobyt powyżej 30 nocy. |
Liczba osób
Określa obsługiwane obłożenie sal.
Wartości w polu enum | |
---|---|
OCCUPANCY_UNSPECIFIED |
Nie określono. |
OCCUPANCY_1 |
Jedna osoba. |
OCCUPANCY_2 |
Dwie osoby. |
OCCUPANCY_3 |
Trzy osoby. |
OCCUPANCY_4 |
Cztery osoby. |
OCCUPANCY_OVER_4 |
Ponad 4 osoby. |