Method: reports.batchGet

{
  "viewId": string,
  "dateRanges": [
    {
      object(DateRange)
    }
  ],
  "samplingLevel": enum(Sampling),
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "metricFilterClauses": [
    {
      object(MetricFilterClause)
    }
  ],
  "filtersExpression": string,
  "orderBys": [
    {
      object(OrderBy)
    }
  ],
  "segments": [
    {
      object(Segment)
    }
  ],
  "pivots": [
    {
      object(Pivot)
    }
  ],
  "cohortGroup": {
    object(CohortGroup)
  },
  "pageToken": string,
  "pageSize": number,
  "includeEmptyRows": boolean,
  "hideTotals": boolean,
  "hideValueRanges": boolean
}

string

Die Analytics-Datenansichts-ID, aus der Daten abgerufen werden sollen Alle ReportRequest innerhalb einer batchGet-Methode müssen dieselbe viewId enthalten.

object(DateRange)

Zeiträume in der Anfrage. Die Anfrage kann maximal zwei Zeiträume umfassen. Die Antwort enthält eine Reihe von Messwerten für jede Kombination der Dimensionen für jeden Zeitraum in der Anfrage. Gibt es also zwei Zeiträume, gibt es zwei Messwerte, einen für den ursprünglichen und einen für den zweiten. Das Feld reportRequest.dateRanges sollte nicht für Kohorten- oder Lifetime-Wert-Anfragen angegeben werden. Wenn kein Zeitraum angegeben ist, wird der Standardzeitraum verwendet: (startDate: aktuelles Datum – 7 Tage, endDate: aktuelles Datum – 1 Tag). Alle ReportRequest innerhalb einer batchGet-Methode müssen dieselbe dateRanges-Definition enthalten.

enum(Sampling)

Die gewünschte Stichprobengröße für den Bericht. Wenn das Feld samplingLevel nicht angegeben ist, wird die Stichprobenebene DEFAULT verwendet. Alle ReportRequest innerhalb einer batchGet-Methode müssen dieselbe samplingLevel-Definition enthalten. Weitere Informationen finden Sie im Entwicklerleitfaden.

object(Dimension)

Die angeforderten Dimensionen. Anfragen können insgesamt neun Dimensionen haben.

object(DimensionFilterClause)

Die Dimensionsfilterklauseln zum Filtern von Dimensionswerten. Sie werden mit dem Operator AND logisch kombiniert. Die Filterung wird durchgeführt, bevor Dimensionen zusammengefasst werden. Die zurückgegebenen Messwerte stellen also nur die Gesamtsumme für die relevanten Dimensionen dar.

object(Metric)

Die angeforderten Messwerte. In Anfragen muss mindestens ein Messwert angegeben werden. Anfragen können insgesamt zehn Messwerte enthalten.

object(MetricFilterClause)

Die Messwertfilterklauseln. Sie werden mit dem Operator AND logisch kombiniert. Bei Messwertfiltern wird nur der erste Zeitraum berücksichtigt, nicht der Vergleichszeitraum. Filter werden erst angewendet, nachdem die Messwerte zusammengefasst wurden.

string

Dimensions- oder Messwertfilter, die die für Ihre Anfrage zurückgegebenen Daten einschränken Wenn Sie filtersExpression verwenden möchten, geben Sie eine Dimension oder einen Messwert für den Filter an, gefolgt vom Filterausdruck. Mit dem folgenden Ausdruck wird beispielsweise die Dimension ga:browser ausgewählt, die mit Firefox beginnt: ga:browser=~^Firefox. Weitere Informationen zu Dimensionen und Messwertfiltern finden Sie in der Referenz zu Filtern.

object(OrderBy)

Sortierreihenfolge in Ausgabezeilen. Beim Vergleich von zwei Zeilen werden die folgenden Elemente der Reihe nach angewendet, bis eine Differenz gefunden wird. Alle Zeiträume in der Ausgabe erhalten die gleiche Zeilenreihenfolge.

object(Segment)

Segmentieren Sie die für die Anfrage zurückgegebenen Daten. Mit einer Segmentdefinition können Sie sich einen Teil der Segmentanfrage ansehen. Eine Anfrage kann bis zu vier Segmente enthalten. Alle ReportRequest innerhalb einer batchGet-Methode müssen dieselbe segments-Definition enthalten. Anfragen mit Segmenten müssen die Dimension ga:segment haben.

object(Pivot)

Die Pivot-Definitionen. Anfragen können maximal zwei Pivot-Elemente haben.

object(CohortGroup)

Kohortengruppe, die dieser Anfrage zugeordnet ist. Wenn die Anfrage eine Kohortengruppe enthält, muss die Dimension ga:cohort vorhanden sein. Alle ReportRequest innerhalb einer batchGet-Methode müssen dieselbe cohortGroup-Definition enthalten.

string

Fortsetzungs-Token für das Abrufen der nächsten Seite mit Ergebnissen. Wenn Sie diesen Parameter zur Anfrage hinzufügen, werden die Zeilen nach dem pageToken zurückgegeben. „pageToken“ sollte der Wert sein, der im Parameter „nextPageToken“ in der Antwort auf die Anfrage „reports.batchGet“ zurückgegeben wird.

number

Die Seitengröße bezieht sich auf die Seitenordnung und gibt die maximale Anzahl der zurückgegebenen Zeilen an. Die Seitengröße muss >= 0 sein. Eine Abfrage gibt den Standardwert von 1.000 Zeilen zurück. Die Analytics Core Reporting API gibt maximal 100.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Sie anfordern. Außerdem können weniger Zeilen als angefordert zurückgegeben werden, falls nicht so viele Dimensionssegmente wie erwartet vorhanden sind. Beispielsweise gibt es weniger als 300 mögliche Werte für ga:country. Wenn Sie also nur nach Land segmentieren, können Sie nicht mehr als 300 Zeilen erhalten, auch wenn Sie pageSize auf einen höheren Wert festgelegt haben.

boolean

Wird die Richtlinie auf „false“ gesetzt, enthält die Antwort keine Zeilen, wenn alle abgerufenen Messwerte null sind. Der Standardwert ist „false“. Dadurch werden diese Zeilen ausgeschlossen.

boolean

Bei Einstellung auf „true“ wird die Gesamtzahl aller Messwerte für alle übereinstimmenden Zeilen und für jeden Zeitraum ausgeblendet. Der Standardwert ist „false“ und gibt die Summe zurück.

boolean

Bei Einstellung auf „true“ werden die Mindest- und Höchstwerte in allen übereinstimmenden Zeilen ausgeblendet. Der Standardwert ist „false“ und es werden die Wertebereiche zurückgegeben.

{
  "name": string,
  "histogramBuckets": [
    string
  ]
}

string

Name der abzurufenden Dimension, z. B. ga:browser.

string (int64 format)

Wenn das Feld nicht leer ist, werden Dimensionswerte in Buckets nach dem String int64 eingefügt. Dimensionswerte, die nicht die Stringdarstellung eines ganzzahligen Werts sind, werden in null konvertiert. Die Bucket-Werte müssen in aufsteigender Reihenfolge angegeben werden. Jeder Bucket ist am unteren Ende geschlossen und am oberen Ende geöffnet. Der erste Bucket enthält alle Werte, die kleiner als die erste Grenze sind. Der Bucket „Letzte“ enthält alle Werte bis unendlich. Dimensionswerte, die in einen Bucket fallen, werden in einen neuen Dimensionswert umgewandelt. Wenn Sie z. B. eine Liste mit &0, 1, 3, 4, 7&quot erhalten, geben wir die folgenden Buckets zurück:

• Bucket 1: Werte < 0, Dimensionswert "<0"
• Bucket 2: Werte in [0,1), Dimensionswert "0"
• Bucket 3: Werte in [1,3), Dimensionswert "1-2"
• Bucket 4: Werte in [3,4), Dimensionswert "3"
• Bucket 5: Werte in [4,7), Dimensionswert &4-6"
• Bucket 6: Werte >= 7, Dimensionswert "7+"

Hinweis: Wenn Sie die Histogrammänderung auf eine Dimension anwenden und diese Dimension sortiert verwenden, sollten Sie zu diesem Zweck den Sortiertyp HISTOGRAM_BUCKET verwenden. Andernfalls werden die Dimensionswerte nach dem Wörterbuch (lexikografisch) sortiert. Die aufsteigende Wörterbuchreihenfolge lautet beispielsweise:

"50", "1001+", "121-1000",50–120"

Die aufsteigende HISTOGRAM_BUCKET-Reihenfolge lautet:

"50", "50-120", "121-1000"1001+"

Der Client muss "orderType": "HISTOGRAM_BUCKET" explizit für eine Histogrammänderungsdimension anfordern.

{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(DimensionFilter)
    }
  ]
}

enum(FilterLogicalOperator)

Der Operator zum Kombinieren mehrerer Dimensionsfilter. Wenn kein Wert angegeben ist, wird er als OR behandelt.

object(DimensionFilter)

Die wiederholten Filter. Sie werden basierend auf dem angegebenen Operator logisch kombiniert.

{
  "dimensionName": string,
  "not": boolean,
  "operator": enum(Operator),
  "expressions": [
    string
  ],
  "caseSensitive": boolean
}

string

Die Dimension, nach der gefiltert wird. Ein Dimensionsfilter muss eine Dimension enthalten.

boolean

Logischer NOT-Operator. Wenn dieser boolesche Wert auf „wahr“ festgelegt wird, werden die entsprechenden Dimensionswerte im Bericht ausgeschlossen. Der Standardwert ist "false".

enum(Operator)

So ordnen Sie die Dimension dem Ausdruck zu. Der Standardwert ist REGEXP.

string

Strings oder regulärer Ausdruck für den Abgleich. Nur der erste Wert der Liste wird zum Vergleich verwendet, es sei denn, der Operator ist IN_LIST. Wenn der Operator IN_LIST verwendet wird, wird die gesamte Liste zum Filtern der Dimensionen verwendet, wie in der Beschreibung des Operators IN_LIST beschrieben.

boolean

Soll die Übereinstimmung zwischen Groß- und Kleinschreibung unterscheiden? Der Standardwert ist "false".

{
  "expression": string,
  "alias": string,
  "formattingType": enum(MetricType)
}

string

Ein Messwertausdruck in der Anfrage. Ein Ausdruck wird aus einem oder mehreren Messwerten und Zahlen erstellt. Zulässige Operatoren sind: Plus (+), Minus (-), Negation (Unary -), Geteilt durch (/), Multipliziert mit (*), Klammern, Positive Kardinalzahlen (0-9) können Dezimalzahlen enthalten und auf 1.024 Zeichen beschränkt sein. Beispiel für ga:totalRefunds/ga:users: In den meisten Fällen ist der Messwertausdruck nur ein einzelner Messwertname wie ga:users. Gemischte MetricType hinzufügen (z.B. CURRENCY + PERCENTAGE) führen zu unerwarteten Ergebnissen.

string

Ein Alias für den Messwertausdruck ist ein alternativer Name für den Ausdruck. Der Alias kann zum Filtern und Sortieren verwendet werden. Dieses Feld ist optional und nützlich, wenn der Ausdruck kein einzelner Messwert ist, sondern ein komplexer Ausdruck, der nicht zum Filtern und Sortieren verwendet werden kann. Der Alias wird auch in der Spaltenüberschrift der Antwort verwendet.

enum(MetricType)

Gibt an, wie der Messwertausdruck formatiert werden soll, z. B. INTEGER.

{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(MetricFilter)
    }
  ]
}

enum(FilterLogicalOperator)

Der Operator zum Kombinieren mehrerer Messwertfilter. Wenn kein Wert angegeben ist, wird er als OR behandelt.

object(MetricFilter)

Die wiederholten Filter. Sie werden basierend auf dem angegebenen Operator logisch kombiniert.

{
  "metricName": string,
  "not": boolean,
  "operator": enum(Operator),
  "comparisonValue": string
}

string

Der Messwert, nach dem gefiltert wird. Ein Messwertfilter muss einen Messwertnamen enthalten. Ein Messwertname kann ein Alias sein, der zuvor als Messwert definiert wurde, oder ein Messwertausdruck.

boolean

Logischer NOT-Operator. Wenn dieser boolesche Wert auf „wahr“ gesetzt wird, werden die übereinstimmenden Messwerte im Bericht ausgeschlossen. Der Standardwert ist "false".

enum(Operator)

Ist der Messwert EQUAL, LESS_THAN oder GREATER_THAN der Vergleichswert, ist der Standardwert EQUAL. Wenn der Operator IS_MISSING ist, wird geprüft, ob der Messwert fehlt, und der Vergleichswert wird ignoriert.

string

Der Wert, mit dem verglichen werden soll.

{
  "fieldName": string,
  "orderType": enum(OrderType),
  "sortOrder": enum(SortOrder)
}

string

Das Feld, nach dem sortiert werden soll. Die standardmäßige Sortierreihenfolge ist aufsteigend. Beispiel: ga:browser. Beachten Sie, dass Sie hier nur ein Feld für die Sortierung angeben können. ga:browser, ga:city ist beispielsweise ungültig.

enum(OrderType)

Der Bestelltyp. Der standardmäßige orderType ist VALUE.

enum(SortOrder)

Die Sortierreihenfolge für das Feld.

{

  // Union field dynamicOrById can be only one of the following:
  "dynamicSegment": {
    object(DynamicSegment)
  },
  "segmentId": string
  // End of list of possible types for union field dynamicOrById.
}

object(DynamicSegment)

Eine Definition des dynamischen Segments in der Anfrage.

string

Die Segment-ID eines integrierten oder benutzerdefinierten Segments, z. B. gaid::-3.

{
  "name": string,
  "userSegment": {
    object(SegmentDefinition)
  },
  "sessionSegment": {
    object(SegmentDefinition)
  }
}

string

Der Name des dynamischen Segments.

object(SegmentDefinition)

Nutzersegment, um Nutzer auszuwählen, die in das Segment aufgenommen werden sollen.

object(SegmentDefinition)

Sitzungssegment, um Sitzungen auszuwählen, die in das Segment aufgenommen werden sollen.

{
  "segmentFilters": [
    {
      object(SegmentFilter)
    }
  ]
}

object(SegmentFilter)

Ein Segment wird durch eine Reihe von Segmentfiltern definiert, die mit einem logischen AND-Vorgang kombiniert werden.

{
  "not": boolean,

  // Union field simpleOrSequence can be only one of the following:
  "simpleSegment": {
    object(SimpleSegment)
  },
  "sequenceSegment": {
    object(SequenceSegment)
  }
  // End of list of possible types for union field simpleOrSequence.
}

boolean

Wenn „true“, wird das Komplement des einfachen oder Sequenzsegments verwendet. Um beispielsweise alle Besuche abzugleichen, die nicht von Berlin stammen, können Sie das Segment so definieren:

  "sessionSegment": {
    "segmentFilters": [{
      "simpleSegment" :{
        "orFiltersForSegment": [{
          "segmentFilterClauses":[{
            "dimensionFilter": {
              "dimensionName": "ga:city",
              "expressions": ["New York"]
            }
          }]
        }]
      },
      "not": "True"
    }]
  },

object(SimpleSegment)

Eine einfache Segmentbedingung besteht aus einer oder mehreren Dimensions- und Messwertbedingungen, die kombiniert werden können.

object(SequenceSegment)

Sequenzbedingungen bestehen aus einem oder mehreren Schritten, wobei jeder Schritt durch mindestens eine Dimension/Messwertbedingung definiert wird. Mehrere Schritte können mit speziellen Sequenzoperatoren kombiniert werden.

{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ]
}

object(OrFiltersForSegment)

Eine Liste von Segmentfiltergruppen, die mit dem logischen Operator AND kombiniert werden.

{
  "segmentFilterClauses": [
    {
      object(SegmentFilterClause)
    }
  ]
}

object(SegmentFilterClause)

Liste der Segmentfilter, die mit einem OR-Operator kombiniert werden sollen.

{
  "not": boolean,

  // Union field dimensionOrMetricFilter can be only one of the following:
  "dimensionFilter": {
    object(SegmentDimensionFilter)
  },
  "metricFilter": {
    object(SegmentMetricFilter)
  }
  // End of list of possible types for union field dimensionOrMetricFilter.
}

boolean

Stimmt mit dem Komplement (!) des Filters überein.

object(SegmentDimensionFilter)

Dimensionsfilter für die Segmentdefinition

object(SegmentMetricFilter)

Messwertfilter für die Segmentdefinition.

{
  "dimensionName": string,
  "operator": enum(Operator),
  "caseSensitive": boolean,
  "expressions": [
    string
  ],
  "minComparisonValue": string,
  "maxComparisonValue": string
}

string

Name der Dimension, auf die der Filter angewendet wird.

enum(Operator)

Der Operator, mit dem die Dimension den Ausdrücken zugeordnet werden soll.

boolean

Bei der Groß-/Kleinschreibung wird zwischen Groß- und Kleinschreibung unterschieden. Ignoriert beim Operator IN_LIST.

string

Die Liste der Ausdrücke. Nur das erste Element wird für alle Operatoren verwendet.

string

Mindestvergleichswerte für BETWEEN Keyword-Option.

string

Maximale Vergleichswerte für BETWEEN Keyword-Option.

{
  "scope": enum(Scope),
  "metricName": string,
  "operator": enum(Operator),
  "comparisonValue": string,
  "maxComparisonValue": string
}

enum(Scope)

Der Umfang eines Messwerts definiert die Ebene, auf der er definiert ist. Der angegebene Messwertbereich muss mindestens so groß sein wie der im Datenmodell definierte primäre Umfang. Der primäre Umfang wird dadurch bestimmt, ob das Segment Nutzer oder Sitzungen auswählt.

string

Der Messwert, nach dem gefiltert wird. Ein metricFilter muss einen Messwertnamen enthalten.

enum(Operator)

Gibt an, welcher Vorgang ausgeführt werden soll, um den Messwert zu vergleichen. Der Standardwert ist EQUAL.

string

Der Wert, mit dem verglichen werden soll. Wenn der Operator BETWEEN ist, wird dieser Wert als Mindestvergleichswert behandelt.

string

Der maximale Vergleichswert wird nur für den Operator BETWEEN verwendet.

{
  "segmentSequenceSteps": [
    {
      object(SegmentSequenceStep)
    }
  ],
  "firstStepShouldMatchFirstHit": boolean
}

object(SegmentSequenceStep)

Die Liste der Schritte in der Sequenz.

boolean

Wenn dies festgelegt ist, muss die Bedingung für den ersten Schritt mit dem ersten Treffer des Besuchers (im Zeitraum) übereinstimmen.

{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ],
  "matchType": enum(MatchType)
}

object(OrFiltersForSegment)

Eine Sequenz wird mit einer Liste von ODER-Filtern angegeben, die mit dem Operator AND kombiniert werden.

enum(MatchType)

Gibt an, ob der Schritt unmittelbar vorausgeht oder vor dem nächsten Schritt liegen kann.

{
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "startGroup": number,
  "maxGroupCount": number
}

object(Dimension)

Eine Liste der Dimensionen, die als Pivot-Spalten angezeigt werden sollen. Ein Pivot kann maximal vier Dimensionen enthalten. Pivot-Dimensionen sind Teil der Beschränkung der Gesamtzahl der Dimensionen, die in der Anfrage zulässig sind.

object(DimensionFilterClause)

DimensionsFilterClauses werden logisch mit einem AND-Operator kombiniert: Nur die Daten, die in all diesen DimensionFilterClauses enthalten sind, tragen zu den Werten in dieser Pivot-Region bei. Mit Dimensionsfiltern können Sie die Spalten im Pivot-Bereich einschränken. Wenn Sie beispielsweise ga:browser als angeforderte Dimension im Pivot-Bereich festgelegt haben und Schlüsselfilter angeben, um ga:browser nur auf IE oder Firefox einzuschränken, werden nur diese beiden Browser als Spalten angezeigt.

object(Metric)

Die Pivot-Messwerte. Pivot-Messwerte sind Teil der Beschränkung der Gesamtzahl von Messwerten in der Anfrage.

number

Wenn k Messwerte angefordert wurden, enthält die Antwort ein datenabhängiges Vielfaches von k Spalten im Bericht. Wenn Sie beispielsweise die Dimension ga:browser verwenden, erhalten Sie k Spalten für Firefox und k Spalten für IE und k Spalten für Chrome sowie für die Reihenfolge der Spaltengruppen in absteigender Reihenfolge für das erste der k-Werte. Gleichungen werden durch lexikografische Reihenfolge der ersten Pivot-Dimension, dann durch lexikografische Reihenfolge der zweiten Pivot-Dimension usw. unterbrochen. Wenn beispielsweise die Summenwerte für den ersten Wert für Firefox, IE und Chrome 8, 2, 8 betrugen, wäre die Reihenfolge der Spalten Chrome, Firefox, IE.

Im Folgenden können Sie auswählen, welche der Gruppen von k Spalten in der Antwort enthalten sein sollen.

number

Gibt die maximale Anzahl der Gruppen an, die zurückgegeben werden sollen. Der Standardwert ist 10, der Höchstwert ist 1.000.

{
  "cohorts": [
    {
      object(Cohort)
    }
  ],
  "lifetimeValue": boolean
}

object(Cohort)

Die Definition der Kohorte.

boolean

Lifetime-Wert (LTV) aktivieren. Der LTV misst den Lifetime-Wert von Nutzern, die über verschiedene Kanäle akquiriert wurden. Weitere Informationen finden Sie unter Kohortenanalyse und Lifetime-Wert, falls der Wert für „LifetimeValue“ falsch ist:

• Die Messwerte ähneln den Werten im Kohortenbericht der Weboberfläche.
• Die Zeiträume für die Kohortendefinition müssen auf die Kalenderwoche und den Monat ausgerichtet sein. Das bedeutet, dass beim Anfordern von ga:cohortNthWeek der startDate in der Kohortendefinition ein Sonntag und der endDate der folgende Samstag sein muss.Für ga:cohortNthMonth sollte der startDate der 1. des Monats und endDate der letzte Tag des Monats sein.

Wenn der Lifetime-Wert „wahr“ ist, gilt Folgendes:

• Die Messwerte entsprechen den Werten im Bericht „LifeTime-Wert“ der Weboberfläche.
• Im Bericht „Lifetime-Wert“ sehen Sie, wie sich der Nutzerwert (Umsatz) und die Interaktionen (App-Aufrufe, Abschlüsse für Zielvorhaben, Sitzungen und Sitzungsdauer) während der 90 Tage nach der Akquisition eines Nutzers steigern.
• Die Messwerte werden als kumulativer Durchschnittswert pro Nutzer pro Zeitintervall berechnet.
• Die Zeiträume für die Kohortendefinition müssen nicht auf die Kalenderwochen- und Monatsgrenzen abgestimmt sein.
• viewId muss eine App-Datenansicht-ID sein.

{
  "name": string,
  "type": enum(Type),
  "dateRange": {
    object(DateRange)
  }
}

string

Ein eindeutiger Name für die Kohorte. Wenn dieser nicht definiert ist, wird der Name automatisch mit den Werten „Kohorte_[1234...]“ generiert.

enum(Type)

Typ der Kohorte. Aktuell wird nur noch FIRST_VISIT_DATE unterstützt. Wenn dieses Feld nicht angegeben ist, wird die Kohorte als FIRST_VISIT_DATE-Kohorte behandelt.

object(DateRange)

Diese wird für FIRST_VISIT_DATE Kohorte verwendet. In der Kohorte werden Nutzer ausgewählt, bei denen das Datum des ersten Besuchs zwischen dem in DateRange definierten Startdatum und Enddatum liegt. Die Zeiträume sollten für Kohortenanfragen angepasst werden. Wenn die Anfrage ga:cohortNthDay enthält, sollte sie genau einen Tag lang sein, bei ga:cohortNthWeek die Wochengrenze (beginnend am Sonntag und endet am Samstag), und für ga:cohortNthMonth der Zeitraum muss auf den Monat (beginnend am ersten und endet am letzten Tag des Monats) ausgerichtet sein. Für Anfragen nach dem LTV gibt es keine solchen Einschränkungen. Für das Feld „reportsRequest.dateRanges“ müssen Sie keinen Zeitraum angeben.

{
  "columnHeader": {
    object(ColumnHeader)
  },
  "data": {
    object(ReportData)
  },
  "nextPageToken": string
}

object(ColumnHeader)

Die Spaltenüberschriften.

object(ReportData)

Antwortdaten.

string

Seitentoken, um die nächste Seite der Ergebnisse in der Liste abzurufen.

{
  "dimensions": [
    string
  ],
  "metricHeader": {
    object(MetricHeader)
  }
}

string

Die Dimensionsnamen in der Antwort.

object(MetricHeader)

Messwertheader für die Messwerte in der Antwort.

{
  "metricHeaderEntries": [
    {
      object(MetricHeaderEntry)
    }
  ],
  "pivotHeaders": [
    {
      object(PivotHeader)
    }
  ]
}

object(MetricHeaderEntry)

Header für die Messwerte in der Antwort.

object(PivotHeader)

Header für die Pivots in der Antwort.

{
  "name": string,
  "type": enum(MetricType)
}

string

Der Name der Kopfzeile.

enum(MetricType)

Der Typ des Messwerts, z. B. INTEGER.

{
  "pivotHeaderEntries": [
    {
      object(PivotHeaderEntry)
    }
  ],
  "totalPivotGroupsCount": number
}

object(PivotHeaderEntry)

Ein Abschnitt mit einem Pivot-Abschnitt.

number

Die Gesamtzahl der Gruppen für diese Pivot-Tabelle.

{
  "dimensionNames": [
    string
  ],
  "dimensionValues": [
    string
  ],
  "metric": {
    object(MetricHeaderEntry)
  }
}

string

Der Name der Dimensionen in der Pivot-Antwort.

string

Die Werte für die Dimensionen im Drehpunkt.

object(MetricHeaderEntry)

Der Messwertheader für den Messwert in der Pivot-Tabelle.

{
  "rows": [
    {
      object(ReportRow)
    }
  ],
  "totals": [
    {
      object(DateRangeValues)
    }
  ],
  "rowCount": number,
  "minimums": [
    {
      object(DateRangeValues)
    }
  ],
  "maximums": [
    {
      object(DateRangeValues)
    }
  ],
  "samplesReadCounts": [
    string
  ],
  "samplingSpaceSizes": [
    string
  ],
  "isDataGolden": boolean,
  "dataLastRefreshed": string
}

object(ReportRow)

Es gibt eine ReportRow für jede eindeutige Kombination von Dimensionen.

object(DateRangeValues)

Für jeden angeforderten Zeitraum, also für alle Zeilen, die der Abfrage entsprechen, wird für jedes angeforderte Werteformat eine Gesamtsumme angezeigt. Die Gesamtsumme für ein Wertformat wird berechnet, indem zuerst die im Wertformat genannten Messwerte addiert und dann das Wertformat als skalarer Ausdruck ausgewertet wird. Beispiel: Für „totals“ wird für 3 / (ga:sessions + 2) 3 / ((sum of all relevant ga:sessions) + 2) berechnet. Die Gesamtsummen werden vor der Paginierung berechnet.

number

Gesamtzahl der übereinstimmenden Zeilen für diese Abfrage.

object(DateRangeValues)

Mindest- und Höchstwerte in allen übereinstimmenden Zeilen. Beide sind leer, wenn hideValueRanges in der Anfrage „false“ ist oder „rowCount“ null ist.

object(DateRangeValues)

Mindest- und Höchstwerte in allen übereinstimmenden Zeilen. Beide sind leer, wenn hideValueRanges in der Anfrage „false“ ist oder „rowCount“ null ist.

string (int64 format)

Wenn die Ergebnisse Stichproben sind, gibt sie die Gesamtzahl der gelesenen Stichproben zurück (ein Eintrag pro Zeitraum). Wenn keine Ergebnisse der Stichprobe vorliegen, ist dieses Feld nicht definiert. Weitere Informationen finden Sie im Entwicklerleitfaden.

string (int64 format)

Wenn die Ergebnisse Stichproben umfassen, wird die Gesamtzahl der vorhandenen Stichproben zurückgegeben, also ein Eintrag pro Zeitraum. Wenn keine Ergebnisse der Stichprobe vorliegen, ist dieses Feld nicht definiert. Weitere Informationen finden Sie im Entwicklerleitfaden.

boolean

Gibt an, ob die Antwort auf diese Anfrage golden ist oder nicht. Daten sind goldgelb, wenn genau dieselbe Anfrage zu einem späteren Zeitpunkt keine neuen Ergebnisse liefert.

string (Timestamp format)

Die letzte Aktualisierung der Daten im Bericht. Alle Treffer, die vor diesem Zeitstempel erzielt wurden, fließen in die Berechnung des Berichts ein.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

{
  "dimensions": [
    string
  ],
  "metrics": [
    {
      object(DateRangeValues)
    }
  ]
}

string

Liste der angeforderten Dimensionen.

object(DateRangeValues)

Liste der Messwerte für jeden angeforderten Zeitraum.

{
  "values": [
    string
  ],
  "pivotValueRegions": [
    {
      object(PivotValueRegion)
    }
  ]
}

string

Jeder Wert entspricht jedem Messwert in der Anfrage.

object(PivotValueRegion)

Die Werte der einzelnen Pivot-Regionen.

{
  "values": [
    string
  ]
}

string

Die Werte der Messwerte in den einzelnen Pivot-Regionen.

{
  "dailyQuotaTokensRemaining": number,
  "hourlyQuotaTokensRemaining": number
}

number

Verbleibendes Ressourcenkontingent übrig.

number

Verbleibende Tokens für stündliches Ressourcenkontingent.