Method: accounts.participationReportViews.query

Ermöglicht das Abfragen (Abrufen, Filtern und Segmentieren) eines Teilnahmeberichts für ein bestimmtes Konto.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter

Parameter
`name`	`string` Der Ressourcenname des Kontos, für das die Abfrage erfolgt. Das Format dafür ist `accounts/{account_id}`.

name

string

Der Ressourcenname des Kontos, für das die Abfrage erfolgt. Das Format dafür ist accounts/{account_id}.

Suchparameter

Parameter
`filter`	`string` Die Bedingungen (Felder und Ausdrücke), die zum Filtern der Messwerte für die Teilnahme für das abgefragte Konto verwendet werden. Die Syntax erfordert Leerzeichen um den Operator `in`. Andernfalls können Leerzeichen weggelassen werden. Bedingungen können mit dem Operator `AND` verknüpft werden. Wichtig:Die richtige Syntax zum Hinzufügen mehrerer Bedingungen lautet: `"?filter=<condition>=<value>%20AND%20<condition>=<value>..."` `date` ist ein Pflichtfeld. Alle anderen sind optional. Beispiele für gültige Bedingungen: `advanceBookingWindow = 2` `advanceBookingWindow >= 0` `advanceBookingWindow <= 5` `checkinDate = '2020-10-01'` `checkinDate >= '2020-10-01'` `checkinDate <= '2020-10-01'` `checkinDate between '2020-10-01' and '2020-10-05'` `date = '2020-02-04'` `date between '2020-02-04' and '2020-02-09'` `deviceType = 'TABLET'` `deviceType in ('MOBILE', 'TABLET')` `hotelRegionCode = 'US'` `hotelRegionCode in ('US', 'CA')` `lengthOfStayDays = 2` `lengthOfStayDays >= 0` `lengthOfStayDays <= 5` `occupancy = 2` `occupancy >= 0` `occupancy <= 5` `occupancy between 1 and 5` `partnerHotelId = 'AAA'` `partnerHotelId in ('AAA', 'BBB')` `userRegionCode = 'US'` `userRegionCode in ('US', 'CA')`
`aggregateBy`	`string` Gibt an, wie die von der Abfrage zurückgegebenen Messwerte segmentiert werden sollen. Wenn beispielsweise `userRegionCode` als `aggregateBy`-Wert angegeben ist, werden im `participationResult` Messwerte nach Nutzerregion aggregiert. Der Stringwert ist eine durch Kommas getrennte Liste von Feldern. Gültige Felder sind: `date`, `userRegionCode`, `deviceType`, `partnerHotelId`, `hotelRegionCode`, `advanceBookingWindow`, `lengthOfStayDays`, `checkinDate` und `occupancy`. Felder, die nicht angegeben sind, sind nicht im ParticipationResult enthalten. Wichtig: Wenn Sie den Parameter `aggregateBy` mit `partnerHotelId` oder mehr als zwei Werten verwenden, kann dies zu einem Fehler führen. Wenn Sie mit `partnerHotelId` und `date` filtern, um die Anzahl der Zeilen zu reduzieren, können Sie Fehler vermeiden.
`pageSize`	`integer` Die maximale Anzahl der zurückzugebenden Teilnahmeergebnisse. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 10.000 Ergebnisse zurückgegeben. Der Höchstwert beträgt 10.000. Werte über 10.000 werden implizit auf 10.000 umgewandelt.
`pageToken`	`string` Ein Seitentoken, das von einer vorherigen participationReportViews.query-Anfrage empfangen wurde. Geben Sie diese an, um die nachfolgende Seite zu empfangen. Beim Paginieren müssen alle anderen für participationReportViews.query bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für ParticipationReportService.QueryParticipationReport.

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

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

Felder

Felder
`results[]`	`object (ParticipationResult)` Die Liste der Ergebnisse, die der Abfrage entsprechen.
`nextPageToken`	`string` Paginierungstoken zum Abrufen der nächsten Ergebnisseite.

results[]

object (ParticipationResult)

Die Liste der Ergebnisse, die der Abfrage entsprechen.

nextPageToken

string

Paginierungstoken zum Abrufen der nächsten Ergebnisseite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ParticipationResult

Stellt ein Ergebnis der Abfrage von Teilnahme-Statistiken für ein Konto dar.

JSON-Darstellung

JSON-Darstellung
{ "key": { object (`Key`) }, "opportunityCount": string, "participationCount": string, "participationPercent": number, "missedParticipationCount": string, "missedParticipationCountDetails": { object (`MissedParticipationCountDetails`) }, "partnerHotelDisplayName": string }

{
  "key": {
    object (Key)
  },
  "opportunityCount": string,
  "participationCount": string,
  "participationPercent": number,
  "missedParticipationCount": string,
  "missedParticipationCountDetails": {
    object (MissedParticipationCountDetails)
  },
  "partnerHotelDisplayName": string
}

Felder
`key`	`object (Key)` Schlüssel des Ergebnisses.
`opportunityCount`	`string (int64 format)` Die Gesamtzahl der Empfehlungen, die für ein bestimmtes Hotel verfügbar waren. Als Empfehlungen wird die Gesamtzahl der Fälle bezeichnet, in denen einem Nutzer eine Hotelanzeige hätte präsentiert werden können.
`participationCount`	`string (int64 format)` Die Gesamtzahl der Empfehlungen, für die Sie am Google Ads-Auktionsprozess teilnehmen konnten.
`participationPercent`	`number` Der Prozentsatz für die Teilnahme. Um ihn zu ermitteln, wird die Anzahl der Empfehlungen, an denen erfolgreich teilgenommen wurde, durch die Gesamtzahl der Empfehlungen geteilt. Wenn beispielsweise eine Unterkunft 90 Mal von 100 Mal für eine Teilnahme an der Google Ads-Auktion empfohlen wurde, beträgt die Teilnahmerate 90%.
`missedParticipationCount`	`string (int64 format)` Gesamtzahl der Empfehlungen, die NICHT für den Google Ads-Auktionsprozess infrage kamen. Umfasst Folgendes: Landingpage fehlt Preis fehlt Problem mit dem Preis Preis nicht verfügbar Sonstiges
`missedParticipationCountDetails`	`object (MissedParticipationCountDetails)` Die Gründe, die zur Anzahl der verpassten Teilnahmen beigetragen haben (z. B. keine Verfügbarkeit), und eine Gesamtzahl für jeden Grund.
`partnerHotelDisplayName`	`string` Den Anzeigenamen des Hotels des Partners. Dieses Feld wird nur ausgefüllt, wenn das Ergebnis nach `partnerHotelId` aggregiert wird.

Schlüssel

Schlüssel eines Ergebnisses.

JSON-Darstellung

JSON-Darstellung
{ "date": { object (`Date`) }, "userRegionCode": string, "deviceType": enum (`Device`), "partnerHotelId": string, "hotelRegionCode": string, "advanceBookingWindow": integer, "lengthOfStayDays": integer, "checkinDate": { object (`Date`) }, "occupancy": integer }

{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "hotelRegionCode": string,
  "advanceBookingWindow": integer,
  "lengthOfStayDays": integer,
  "checkinDate": {
    object (Date)
  },
  "occupancy": integer
}

Felder
`date`	`object (Date)` Das Datum, für das Sie Messwerte anfordern. Wenn `date` kein Wert des Parameters `aggregateBy` im Anfragedurchlauf ist, wird das Feld `date` nicht in `Key` zurückgegeben.
`userRegionCode`	`string` Der ISO 3116-Regionscode des Landes/der Region des Nutzers. Wenn `userRegionCode` kein Wert des Parameters `aggregateBy` im Anfragedurchlauf ist, wird das Feld `userRegionCode` nicht in `Key` zurückgegeben.
`deviceType`	`enum (Device)` Der Gerätetyp des Nutzers. Wenn `deviceType` kein Wert des Parameters `aggregateBy` im Anfragedurchlauf ist, wird das Feld `deviceType` nicht in `Key` zurückgegeben.
`partnerHotelId`	`string` Hotel-ID des Partners. Wenn `partnerHotelId` kein Wert des Parameters `aggregateBy` im Anfragedurchlauf ist, wird das Feld `partnerHotelId` nicht in `Key` zurückgegeben.
`hotelRegionCode`	`string` CLDR-Regionscode des Landes bzw. der Region des Hotels. Wenn `hotelRegionCode` kein Wert des Parameters `aggregateBy` im Anfragedurchlauf ist, wird das Feld `hotelRegionCode` nicht in `Key` zurückgegeben.
`advanceBookingWindow`	`integer` Die Anzahl der Tage, die der Nutzer im Voraus buchen möchte. Wenn `advanceBookingWindow` kein Wert des Parameters `aggregateBy` im Anfragedurchlauf ist, wird das Feld `advanceBookingWindow` nicht in `Key` zurückgegeben.
`lengthOfStayDays`	`integer` Die Anzahl der Übernachtungen für den Reiseplan. Wenn `lengthOfStayDays` kein Wert des Parameters `aggregateBy` im Anfragedurchlauf ist, wird das Feld `lengthOfStayDays` nicht in `Key` zurückgegeben.
`checkinDate`	`object (Date)` Das Check-in-Datum des Reiseplans. Wenn `checkinDate` kein Wert des Parameters `aggregateBy` im Anfragedurchlauf ist, wird das Feld `checkinDate` nicht in `Key` zurückgegeben.
`occupancy`	`integer` Die Gesamtauslastung des Reiseplans. Wenn `occupancy` kein Wert des Parameters `aggregateBy` im Anfragedurchlauf ist, wird das Feld `occupancy` nicht in `Key` zurückgegeben.

MissedParticipationCountDetails

Anzahl der verpassten Teilnahmen nach Grund aufgeschlüsselt.

JSON-Darstellung

JSON-Darstellung
{ "noAvailabilityCount": string, "hotelSuspendedCount": string, "noTaxBreakdownCount": string, "noLandingPageCount": string, "noPriceCount": string, "noPriceCountDetails": { object (`NoPriceCountDetails`) }, "otherReasonCount": string, "priceMissingCount": string, "priceMissingCountDetails": { object (`PriceMissingCountDetails`) }, "priceProblemCount": string, "priceProblemCountDetails": { object (`PriceProblemCountDetails`) }, "priceUnavailableCount": string, "priceUnavailableCountDetails": { object (`PriceUnavailableCountDetails`) } }

{
  "noAvailabilityCount": string,
  "hotelSuspendedCount": string,
  "noTaxBreakdownCount": string,
  "noLandingPageCount": string,
  "noPriceCount": string,
  "noPriceCountDetails": {
    object (NoPriceCountDetails)
  },
  "otherReasonCount": string,
  "priceMissingCount": string,
  "priceMissingCountDetails": {
    object (PriceMissingCountDetails)
  },
  "priceProblemCount": string,
  "priceProblemCountDetails": {
    object (PriceProblemCountDetails)
  },
  "priceUnavailableCount": string,
  "priceUnavailableCountDetails": {
    object (PriceUnavailableCountDetails)
  }
}

Felder
`noAvailabilityCount (deprecated)`	`string (int64 format)` Dieses Element wird nicht mehr unterstützt. Die Gesamtzahl der verpassten Teilnahmen aufgrund einer nicht verfügbaren Kombination aus Hotel und Reiseplan oder weil der Nutzer nicht für die Preise infrage kam. Damit Sie an diesen Auktionen teilnehmen können, müssen Sie möglicherweise zusätzliche Preisinformationen angeben.
`hotelSuspendedCount (deprecated)`	`string (int64 format)` Dieses Element wird nicht mehr unterstützt. Die Gesamtzahl der verpassten Teilnahmen aufgrund der Sperrung eines oder mehrerer Ihrer Hotels wegen Verstößen gegen die Preisgenauigkeit.
`noTaxBreakdownCount (deprecated)`	`string (int64 format)` Dieses Element wird nicht mehr unterstützt. Die Gesamtzahl der verpassten Teilnahmen aufgrund der fehlenden separaten Angabe von Steuern und Gebühren für eines oder mehrere Ihrer Hotels.
`noLandingPageCount`	`string (int64 format)` Keine Landingpage stimmte mit der Nutzeranfrage überein.
`noPriceCount (deprecated)`	`string (int64 format)` Dieses Element wird nicht mehr unterstützt. Die Gesamtzahl der verpassten Teilnahmen aufgrund eines fehlenden Preisangebots für den angefragten Reiseplan.
`noPriceCountDetails (deprecated)`	`object (NoPriceCountDetails)` Dieses Element wird nicht mehr unterstützt. Die Gründe, die zur Anzahl der Fälle ohne Preis beigetragen haben (z. B. keine Livepreise verfügbar), und die Gesamtzahl für jeden Grund.
`otherReasonCount`	`string (int64 format)` Das Hotel hat aus einem unbekannten Grund nicht teilgenommen.
`priceMissingCount`	`string (int64 format)` Die Gesamtzahl der verpassten Teilnahmen aufgrund nicht verfügbarer Preise im Cache von Google oder keiner erfolgreichen Antwort auf Livepreise. Umfasst Folgendes: Bandbreite aufgebraucht Cache-Preis fehlt Reiseplan blockiert Livepreise nicht eingerichtet Livepreis-Zeitüberschreitung Livepreis-Fehler
`priceMissingCountDetails`	`object (PriceMissingCountDetails)` Die Gründe für die Anzahl der fehlenden Preise.
`priceProblemCount`	`string (int64 format)` Die Gesamtzahl der verpassten Teilnahmen aufgrund ungenauer Preise für den Reiseplan. Umfasst Folgendes: Hotel gesperrt Preis ungewöhnlich hoch Preis ungewöhnlich niedrig Steuern und Feeds fehlen
`priceProblemCountDetails`	`object (PriceProblemCountDetails)` Die Gründe, die zur Anzahl der Preisprobleme beigetragen haben.
`priceUnavailableCount`	`string (int64 format)` Die Gesamtzahl der verpassten Teilnahmen aufgrund der Kennzeichnung des Preises als „nicht verfügbar“ (-1) für den angefragten Reiseplan. Umfasst Folgendes: Preis nicht verfügbar Teilnahme nicht wahrscheinlich Sonstiges
`priceUnavailableCountDetails`	`object (PriceUnavailableCountDetails)` Die Gründe, die zur Anzahl der nicht verfügbaren Preise beigetragen haben.

NoPriceCountDetails

Die Gründe, die zur Anzahl ohne Preis beigetragen haben, und die Gesamtzahl für jeden Grund.

JSON-Darstellung
{ "livePricingTechnicalIssueCount": string, "livePricingNotTriggeredCount": string, "livePricingConfigIssueCount": string, "livePricingNotAvailableCount": string, "livePricingOtherReasonCount": string }

JSON-Darstellung

{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}

Felder
`livePricingTechnicalIssueCount`	`string (int64 format)` Die Gesamtzahl der verpassten Teilnahmen aufgrund von technischen Problemen mit Livepreisen aus einem der folgenden Gründe: Sie haben nicht schnell genug geantwortet und die Antwortfrist (ca. 4.000 Millisekunden) überschritten. Sie haben einen Fehler zurückgegeben. Ihre Antwort war fehlerhaft.
`livePricingNotTriggeredCount`	`string (int64 format)` Die Gesamtzahl der verpassten Teilnahmen aufgrund von nicht ausgelösten Livepreisen aus einem der folgenden Gründe: Sie haben kein Gebot festgelegt. Sie hatten keine gültige Landingpage. Der Cache enthielt nicht genügend Preise.
`livePricingConfigIssueCount`	`string (int64 format)` Die Gesamtzahl der verpassten Teilnahmen aufgrund von nicht ausgelösten Livepreisen aus einem der folgenden Gründe: Sie haben keine Livepreise für diese Suchanfragen konfiguriert. Sie haben den Zugriff von Google auf den betreffenden Hotelbuchungsplan eingeschränkt.
`livePricingNotAvailableCount`	`string (int64 format)` Die Gesamtzahl der verpassten Teilnahmen aufgrund nicht verfügbarer Livepreise. Für bestimmte Standardreisepläne oder Benutzeroberflächen werden Livepreise nicht ausgelöst. In diesem Fall benötigen Partner einen im Cache gespeicherten Preis, um teilnehmen zu können.
`livePricingOtherReasonCount`	`string (int64 format)` Die Anzahl der verpassten Teilnahmen aufgrund anderer Probleme mit Livepreisen.

PriceMissingCountDetails

Die Gründe, die zur Anzahl der fehlenden Preise beigetragen haben, und die Gesamtzahl für jeden Grund.

JSON-Darstellung
{ "cacheRateMissingCount": string, "itineraryBlockedCount": string, "livePricingNotSetupCount": string, "bandwidthDepletedCount": string, "livePricingTimeoutCount": string, "livePricingErrorCount": string }

JSON-Darstellung

{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}

Felder
`cacheRateMissingCount`	`string (int64 format)` Für diesen Reiseplan ist kein Preis im Cache vorhanden. Aufgrund von Seitenbeschränkungen wurde keine Liveabfrage durchgeführt.
`itineraryBlockedCount`	`string (int64 format)` Der Reiseplan lag außerhalb Ihrer grundlegenden Parameter. Daher wurde kein Preis aus der Liveabfrage oder dem Cache abgerufen.
`livePricingNotSetupCount`	`string (int64 format)` Für diesen Reiseplan wurde kein Preis im Cache gespeichert und für dieses Konto wurde keine Liveabfrage konfiguriert.
`bandwidthDepletedCount`	`string (int64 format)` Für diesen Reiseplan wurde kein Preis im Cache gespeichert und es gab kein verbleibendes Kontingent für Liveabfragen.
`livePricingTimeoutCount`	`string (int64 format)` Für diesen Reiseplan wurde kein Preis im Cache gespeichert und bei einer an Ihr System gesendeten Liveabfrage ist eine Zeitüberschreitung aufgetreten.
`livePricingErrorCount`	`string (int64 format)` Für diesen Reiseplan wurde kein Preis im Cache gespeichert. Es gab keine Zeitüberschreitung bei der Liveabfrage, aber Ihr System hat einen Fehler zurückgegeben.

PriceProblemCountDetails

Die Gründe, die zur Anzahl der Preisprobleme beigetragen haben, und die Gesamtzahl für jeden Grund.

JSON-Darstellung
{ "hotelSuspendedCount": string, "priceUnusuallyHighCount": string, "priceUnusuallyLowCount": string, "taxesAndFeesMissingCount": string, "basePriceViolationsCount": string, "priceAccuracyIssueCount": string }

JSON-Darstellung

{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string,
  "basePriceViolationsCount": string,
  "priceAccuracyIssueCount": string
}

Felder
`hotelSuspendedCount`	`string (int64 format)` Das Hotel wurde gesperrt. Dies kann durch dauerhaft inkorrekte Angaben bei Steuern und Gebühren verursacht werden.
`priceUnusuallyHighCount`	`string (int64 format)` Der Preis für diesen Reiseplan schien im Vergleich zu regionalen Trends ungewöhnlich hoch zu sein.
`priceUnusuallyLowCount`	`string (int64 format)` Der Preis für diesen Reiseplan schien im Vergleich zu regionalen Trends ungewöhnlich niedrig zu sein.
`taxesAndFeesMissingCount`	`string (int64 format)` Steuern und Gebühren waren nicht im Preis enthalten.
`basePriceViolationsCount`	`string (int64 format)` Der Basispreis ist im Verhältnis zum Gesamtpreis zu niedrig.
`priceAccuracyIssueCount`	`string (int64 format)` Problem mit der Preisgenauigkeit.

PriceUnavailableCountDetails

Die Gründe, die zur Anzahl der nicht verfügbaren Preise beigetragen haben, und die Gesamtzahl für jeden Grund.

JSON-Darstellung
{ "priceUnavailableCount": string, "participationNotLikelyCount": string }

Felder

Felder
`priceUnavailableCount`	`string (int64 format)` Das Hotel hat nicht teilgenommen, weil es zu den Reisedaten nicht verfügbar war.
`participationNotLikelyCount`	`string (int64 format)` Für diesen Reiseplan wurde kein Preis im Cache gespeichert und es wurde keine Liveabfrage durchgeführt, weil Ihr Server normalerweise meldet, dass das Hotel nicht verfügbar oder voll ist.

priceUnavailableCount

string (int64 format)

Das Hotel hat nicht teilgenommen, weil es zu den Reisedaten nicht verfügbar war.

participationNotLikelyCount

string (int64 format)

Für diesen Reiseplan wurde kein Preis im Cache gespeichert und es wurde keine Liveabfrage durchgeführt, weil Ihr Server normalerweise meldet, dass das Hotel nicht verfügbar oder voll ist.

Method: accounts.participationReportViews.query Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

HTTP-Anfrage

Pfadparameter

Suchparameter

Anfragetext

Antworttext

Autorisierungsbereiche

ParticipationResult

Schlüssel

MissedParticipationCountDetails

NoPriceCountDetails

PriceMissingCountDetails

PriceProblemCountDetails

PriceUnavailableCountDetails

Method: accounts.participationReportViews.query