- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- FreeBookingLinksResult
WYCOFANO: zamiast tego użyj raportu PropertyPerformanceReportService.QueryPropertyPerformanceReport
, który udostępnia też raporty o wyświetleniach. Umożliwia przeszukiwanie (pobieranie, filtrowanie i segmentowanie) bezpłatnego raportu o linkach do rezerwacji związanych z konkretnym kontem.
Żądanie HTTP
GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/freeBookingLinksReportViews: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) służące do filtrowania danych o bezpłatnych linkach do rezerwacji dotyczących 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:
WYCOFANO: zamiast tego użyj właściwości QueryPropertyPerformanceReportResponse
z PropertyPerformanceReportService
. Odpowiedź na: FreeBookingLinksReportService.QueryFreeBookingLinksReport
.
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.
WynikFreeBookingLinks
WYCOFANO: zamiast tego użyj właściwości PropertyPerformanceResult
z PropertyPerformanceReportService
. Reprezentuje wynik zapytania o bezpłatne statystyki linku do konta.
Zapis JSON |
---|
{ "date": { object ( |
Pola | |
---|---|
date |
Data w wybranym zakresie dat. 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ść |
deviceType |
Typ urządzenia użytkownika. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
partnerHotelId |
Identyfikator hotelu partnera. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
partnerHotelDisplayName |
Nazwa hotelu partnera. Jest obecny tylko wtedy, gdy w żądaniu określono właściwość |
clickCount |
Łączna liczba kliknięć zarejestrowanych dla tego wyniku. |