Method: accounts.freeBookingLinksReportViews.query

EINGESTELLT: Verwenden Sie stattdessen PropertyPerformanceReportService.QueryPropertyPerformanceReport. Dieser Bericht umfasst auch Impressionsberichte. Ermöglicht das Abfragen, Filtern und Segmentieren eines Berichts zu kostenlosen Buchungslinks für ein bestimmtes Konto.

HTTP-Request

GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/freeBookingLinksReportViews:query

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Der Ressourcenname des abgefragten Kontos. Format: accounts/{Konto_ID}

Abfrageparameter

Parameter
filter

string

Die Bedingungen (Felder und Ausdrücke), mit denen die kostenlosen Messwerte für Buchungslinks für das abgefragte Konto gefiltert werden. Die Syntax erfordert Leerzeichen um den Operator in. Andernfalls können Leerzeichen weggelassen werden. Bedingungen können mit dem Operator and zusammengeführt werden.

date ist ein Pflichtfeld. Alle anderen sind optional.

Die Feldwerte für date sind einschließlich und müssen im Format JJJJ-MM-TT angegeben werden. Das früheste gültige Datum ist der 09.03.2021. Vorherige Datumswerte werden auf den 09.03.2021 umgewandelt.

Bei den Werten für partnerHotelDisplayName wird die Groß- und Kleinschreibung nicht berücksichtigt.

Beispiele für gültige Bedingungen:

  • date = '2021-12-03'
  • date between '2021-12-03' and '2021-12-08'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • partnerHotelDisplayName = 'hotel A'
  • partnerHotelDisplayName in ('Hotel A', 'HOTEL b')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

Gibt an, wie die von der Abfrage zurückgegebenen Messwerte segmentiert werden. Wenn beispielsweise userRegionCode angegeben ist, liefert freeBookingLinksResult Messwerte, die nach Nutzerregion zusammengefasst sind.

Der Stringwert ist eine durch Kommas getrennte Liste von Feldern. Gültige Felder sind: date, userRegionCode, deviceType, partnerHotelId und partnerHotelDisplayName. Nur die hier angegebenen Felder sind in dem FreeBookingLinksResult enthalten.
pageSize

integer

Die maximale Anzahl der Ergebnisse, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 10.000 Ergebnisse zurückgegeben. Der Höchstwert ist 10.000. Werte über 10.000 werden zu 10.000 gezwungen.
pageToken

string

Ein Seiten-Token, das von einer früheren Teilnahmeberichtsanforderung empfangen wurde. Geben Sie diese an, um die nachfolgende Seite zu erhalten.

Bei der Paginierung müssen alle anderen für „biladeReportViews.query“ angegebenen Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

VERWORFEN: Verwenden Sie stattdessen QueryPropertyPerformanceReportResponse mit PropertyPerformanceReportService. Antwortnachricht für FreeBookingLinksReportService.QueryFreeBookingLinksReport.

JSON-Darstellung 
{
  "results": [
    {
      object (FreeBookingLinksResult)
    }
  ],
  "nextPageToken": string
}
Felder
results[]

object (FreeBookingLinksResult)

Die Liste der Ergebnisse, die der Abfrage entsprechen.
nextPageToken

string

Das Paginierungstoken, das zum Abrufen der nächsten Ergebnisseite verwendet wird. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/travelpartner

Weitere Informationen finden Sie unter OAuth 2.0.

FreeBookingLinksResult

VERWORFEN:Verwenden Sie stattdessen PropertyPerformanceResult mit PropertyPerformanceReportService. Stellt ein Ergebnis aus der Abfrage von Statistiken zu kostenlosen Buchungslinks für ein Konto dar.

JSON-Darstellung 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
Felder
date

object (Date)

Ein Datum innerhalb des angeforderten Zeitraums.

Ist nur vorhanden, wenn in der Anfrage date in aggregateBy angegeben ist.
userRegionCode

string

Der ISO 3116-Regionscode des Landes bzw. der Region des Nutzers.

Nur vorhanden, wenn in der Anfrage userRegionCode in aggregateBy angegeben ist
deviceType

enum (Device)

Der Gerätetyp des Nutzers.

Ist nur vorhanden, wenn in der Anfrage deviceType in aggregateBy angegeben ist.
partnerHotelId

string

Hotel-ID des Partners

Ist nur vorhanden, wenn in der Anfrage partnerHotelId in aggregateBy angegeben ist.
partnerHotelDisplayName

string

Hotelname des Partners

Ist nur vorhanden, wenn in der Anfrage partnerHotelDisplayName in aggregateBy angegeben ist.
clickCount

string (int64 format)

Die Gesamtzahl der Klicks, die für dieses Ergebnis erfasst wurden.