Method: properties.runPivotReport

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Gibt einen benutzerdefinierten Pivot-Bericht Ihrer Google Analytics-Ereignisdaten zurück Pivot-Berichte sind komplexere und ausdrucksstärkere Formate als reguläre Berichte. In einem Pivot-Bericht sind Dimensionen nur sichtbar, wenn sie in einem Pivot-Bericht enthalten sind. Sie können mehrere Pivot-Tabellen angeben, um die Daten weiter zu segmentieren.

HTTP-Anfrage

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
property

string

Eine GA4-Property-ID, deren Ereignisse erfasst werden. Sie wird im URL-Pfad und nicht im Text angegeben. Weitere Informationen zum Ermitteln der Property-ID Innerhalb einer Batchanfrage sollte diese Property entweder nicht angegeben sein oder mit der Batch-Property übereinstimmen.

Beispiel: properties/1234

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Felder
dimensions[]

object (Dimension)

Die angeforderten Dimensionen. Alle definierten Dimensionen müssen in einem der folgenden Formate verwendet werden: dimensionsExpression, dimensionsFilter, pivots, orderBys.
metrics[]

object (Metric)

Es muss mindestens ein Messwert angegeben werden. Alle definierten Messwerte müssen von einem der folgenden Werte verwendet werden: Messwertausdruck, Messwertfilter, OrderBys.
dateRanges[]

object (DateRange)

Zeitraum zum Abrufen der Ereignisdaten für den Bericht Wenn mehrere Zeiträume angegeben sind, werden Ereignisdaten aus jedem Zeitraum im Bericht verwendet. Eine besondere Dimension mit dem Feldnamen "dateRange" kann in den Feldnamen eines Pivot-Felds enthalten sein. Ist dies der Fall, vergleicht der Bericht die Zeiträume. In einer Kohortenanfrage muss dateRanges angegeben werden.
pivots[]

object (Pivot)

Beschreibt das visuelle Format der Berichtsdimensionen in Spalten oder Zeilen. Die Vereinigung der Feldnamen (Dimensionsnamen) in allen Pivot-Tabellen muss eine Teilmenge der Dimensionsnamen sein, die in den Dimensionen definiert sind. Zwei Pivots können keine gemeinsame Dimension haben. Eine Dimension ist nur dann sichtbar, wenn sie in einem Pivot angezeigt wird.
dimensionFilter

object (FilterExpression)

Die Filterklausel mit den Dimensionen. Für diesen Filter müssen Dimensionen angefordert werden. In diesem Filter können keine Messwerte verwendet werden.
metricFilter

object (FilterExpression)

Die Filterklausel mit Messwerten. Wird nach der Zusammenfassung angewendet, ähnlich wie bei der SQL-Klausel. Zur Verwendung in diesem Filter müssen Messwerte angefordert werden. In diesem Filter können keine Dimensionen verwendet werden.
currencyCode

string

Ein Währungscode im ISO4217-Format, z. B. "AED", "USD", "JPY". Ist das Feld leer, wird im Bericht die Standardwährung der Property verwendet.
cohortSpec

object (CohortSpec)

Kohortengruppe, die dieser Anfrage zugeordnet ist. Wenn die Anfrage eine Kohortengruppe enthält, muss die Dimension „Kohorte“ vorhanden sein.
keepEmptyRows

boolean

Wenn „false“ oder nicht angegeben, wird nicht jede Zeile zurückgegeben, deren Messwerte null sind. Bei „true“ werden diese Zeilen zurückgegeben, wenn sie nicht separat durch einen Filter entfernt werden.
returnPropertyQuota

boolean

Gibt an, ob der aktuelle Status des Kontingents für diese Analytics-Property zurückgegeben werden soll. Das Kontingent wird in PropertyKontingent zurückgegeben.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von RunPivotReportResponse.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics