Method: reports.batchGet

Gibt die Analytics-Daten zurück.

HTTP-Anfrage

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "reportRequests": [
    {
      object(ReportRequest)
    }
  ],
  "useResourceQuotas": boolean
}
Felder
reportRequests[]

object(ReportRequest)

Jede Anfrage erhält eine separate Antwort. Es sind maximal fünf Anfragen möglich. Alle Anfragen sollten dieselben Werte für dateRanges, viewId, segments, samplingLevel und cohortGroup haben.

useResourceQuotas

boolean

Aktiviert ressourcenbasierte Kontingente (standardmäßig False). Wenn dieses Feld auf True gesetzt ist, werden die Kontingente pro Ansicht (Profil) durch die Berechnungskosten der Anfrage geregelt. Beachten Sie, dass bei kostenbasierten Kontingenten mehr Stichprobenraten aktiviert werden. (10 Millionen für SMALL, 100 Mio. für LARGE. Weitere Informationen finden Sie in der Dokumentation zu Limits und Kontingenten.

Antworttext

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

Die Hauptantwortklasse, die die Berichte aus dem batchGet-Aufruf der Reporting API enthält.

JSON-Darstellung 
{
  "reports": [
    {
      object(Report)
    }
  ],
  "queryCost": number,
  "resourceQuotasRemaining": {
    object(ResourceQuotasRemaining)
  }
}
Felder
reports[]

object(Report)

Antworten, die den einzelnen Anfragen entsprechen.

queryCost

number

Die Menge der Ressourcenkontingenttokens, die zum Ausführen der Abfrage abgezogen wurden. Enthält alle Antworten.

resourceQuotasRemaining

object(ResourceQuotasRemaining)

Das verbleibende Ressourcenkontingent für die Property.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

ReportRequest

Die Hauptanfrageklasse, die die Reporting API-Anfrage angibt.

JSON-Darstellung 
{
  "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
}
Felder
viewId

string

Die ID der Analytics-Datenansicht, für die Daten abgerufen werden sollen Jede ReportRequest innerhalb einer batchGet-Methode muss dieselbe viewId enthalten.

dateRanges[]

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. Wenn es also zwei Zeiträume gibt, werden zwei Messwerte angezeigt: einer für den ursprünglichen Zeitraum und einer für den zweiten Zeitraum. Das Feld „reportRequest.dateRanges“ sollte nicht für Kohorten oder Anfragen zum Lifetime-Wert angegeben werden. Wenn kein Zeitraum angegeben ist, wird der Standardzeitraum wie folgt verwendet (startDate: aktuelles Datum – 7 Tage, endDate: aktuelles Datum – 1 Tag). Jeder ReportRequest innerhalb einer batchGet-Methode muss dieselbe dateRanges-Definition enthalten.

samplingLevel

enum(Sampling)

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

dimensions[]

object(Dimension)

Die angeforderten Abmessungen. Anfragen können insgesamt 9 Dimensionen haben.

dimensionFilterClauses[]

object(DimensionFilterClause)

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

metrics[]

object(Metric)

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

metricFilterClauses[]

object(MetricFilterClause)

Die Messwertfilterklauseln. Sie werden logisch mit dem Operator AND kombiniert. Bei Messwertfiltern wird nur der erste Zeitraum berücksichtigt, nicht der Vergleichszeitraum. Beachten Sie, dass nach Messwerten gefiltert wird, nachdem die Messwerte zusammengefasst wurden.

filtersExpression

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 an, nach der bzw. dem gefiltert werden soll, 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 unter Filterreferenz.

orderBys[]

object(OrderBy)

Sortierreihenfolge der Ausgabezeilen. Um zwei Zeilen zu vergleichen, werden die folgenden Elemente der Reihe nach angewendet, bis eine Differenz gefunden wird. Alle Zeiträume in der Ausgabe erhalten dieselbe Zeilenreihenfolge.

segments[]

object(Segment)

Segmentieren Sie die für die Anfrage zurückgegebenen Daten. Eine Segmentdefinition hilft dabei, einen Teil der Segmentanfrage zu betrachten. Eine Anfrage kann bis zu vier Segmente enthalten. Jeder ReportRequest innerhalb einer batchGet-Methode muss dieselbe segments-Definition enthalten. Anfragen mit Segmenten müssen die Dimension ga:segment haben.

pivots[]

object(Pivot)

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

cohortGroup

object(CohortGroup)

Die mit dieser Anfrage verknüpfte Kohortengruppe. Wenn die Anfrage eine Kohortengruppe enthält, muss die Dimension ga:cohort vorhanden sein. Jeder ReportRequest innerhalb einer batchGet-Methode muss dieselbe cohortGroup-Definition enthalten.

pageToken

string

Fortsetzungs-Token für den Abruf der nächsten Ergebnisseite. Wenn Sie dies zur Anfrage hinzufügen, werden die Zeilen nach dem pageToken zurückgegeben. Das pageToken sollte der Wert sein, der im Parameter „nextPageToken“ in der Antwort auf die Anfrage „reports.batchGet“ zurückgegeben wird.

pageSize

number

Die Seitengröße gilt für das Paging und gibt die maximale Anzahl der zurückgegebenen Zeilen an. Die Seitengröße muss größer als 0 sein. Eine Abfrage gibt standardmäßig 1.000 Zeilen zurück. Die Analytics Core Reporting API gibt maximal 100.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen Sie anfordern. Es können auch weniger Zeilen als angefordert zurückgegeben werden, wenn nicht so viele Dimensionssegmente wie erwartet vorhanden sind. Wenn für ga:country beispielsweise weniger als 300 Werte möglich sind, können Sie bei einer ausschließlichen Segmentierung nach Land nicht mehr als 300 Zeilen erhalten, selbst wenn Sie für pageSize einen höheren Wert festlegen.

includeEmptyRows

boolean

Wenn der Wert auf „false“ gesetzt ist, enthält die Antwort keine Zeilen, wenn alle abgerufenen Messwerte gleich null sind. Der Standardwert ist „false“, wodurch diese Zeilen ausgeschlossen werden.

hideTotals

boolean

Wenn die Richtlinie auf „true“ gesetzt ist, wird die Summe aller Messwerte für alle übereinstimmenden Zeilen und für jeden Zeitraum ausgeblendet. Der Standardwert ist „false“ und gibt die Gesamtsummen zurück.

hideValueRanges

boolean

Wenn die Richtlinie auf „true“ gesetzt ist, werden die Mindest- und Höchstwerte in allen übereinstimmenden Zeilen ausgeblendet. Der Standardwert ist „false“ und die Wertebereiche werden zurückgegeben.

Probenahme

Werte für die Stichprobenebene.

Enums
SAMPLING_UNSPECIFIED Wenn das Feld samplingLevel nicht angegeben ist, wird die Stichprobenebene DEFAULT verwendet.
DEFAULT Gibt die Antwort mit einer Stichprobengröße zurück, die ein Gleichgewicht zwischen Geschwindigkeit und Genauigkeit herstellt.
SMALL Sie gibt eine schnelle Antwort mit einer kleineren Stichprobengröße zurück.
LARGE Gibt mithilfe einer großen Stichprobe eine genauere Antwort zurück. Dies kann jedoch dazu führen, dass die Reaktionszeit langsamer ist.

Dimension

Dimensionen sind Attribute Ihrer Daten. Die Dimension ga:city gibt beispielsweise die Stadt an, in der die Sitzung gestartet wurde, etwa „Paris“ oder „New York“.

JSON-Darstellung 
{
  "name": string,
  "histogramBuckets": [
    string
  ]
}
Felder
name

string

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

histogramBuckets[]

string (int64 format)

Wenn sie nicht leer ist, werden Dimensionswerte in Buckets nach dem String „int64“ platziert. Dimensionswerte, die nicht die Zeichenfolgendarstellung eines Integralwerts sind, werden in Null umgewandelt. Die Bucket-Werte müssen in aufsteigender Reihenfolge angegeben werden. Jeder Bucket wird am unteren Ende geschlossen und am oberen Ende offen. Der „erste“ Bucket enthält alle Werte, die kleiner als der erste Grenzwert sind, der „letzte“ Bucket alle Werte bis unendlich. Dimensionswerte, die in eine Gruppe fallen, werden in einen neuen Dimensionswert umgewandelt. Wenn zum Beispiel eine Liste mit "0, 1, 3, 4, 7" zurückgegeben wird, werden die folgenden Buckets zurückgegeben:

  • Bucket Nr. 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 Nr. 5: Werte in [4,7), Dimensionswert „4–6“
  • Bucket 6: Werte >= 7, Dimensionswert „7+“

HINWEIS: Wenn Sie eine Histogrammmutation auf eine Dimension anwenden und diese Dimension zum Sortieren verwenden, sollten Sie hierfür den Sortiertyp HISTOGRAM_BUCKET verwenden. Andernfalls werden die Dimensionswerte nach der Wörterbuchreihenfolge (lexikographisch) sortiert. Die aufsteigende Wörterbuchreihenfolge lautet beispielsweise:

„<50“, „1001+“, „121–1000“, „50–120“

Und die aufsteigende HISTOGRAM_BUCKET-Reihenfolge lautet:

„<50“, „50–120“, „121–1000“, „1001+“

Der Client muss für eine mit dem Histogramm veränderte Dimension explizit "orderType": "HISTOGRAM_BUCKET" anfordern.

DimensionFilterClause

Eine Gruppe von Dimensionsfiltern. Legen Sie den Operatorwert fest, um anzugeben, wie die Filter logisch kombiniert werden sollen.

JSON-Darstellung 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(DimensionFilter)
    }
  ]
}
Felder
operator

enum(FilterLogicalOperator)

Der Operator zum Kombinieren mehrerer Dimensionsfilter. Wenn keine Angabe erfolgt, wird es als OR behandelt.

filters[]

object(DimensionFilter)

Der wiederholte Satz von Filtern. Sie werden basierend auf dem angegebenen Operator logisch kombiniert.

FilterLogicalOperator

Wie die Filter logisch kombiniert werden.

Enums
OPERATOR_UNSPECIFIED Der Operator ist nicht angegeben. Er wird als OR behandelt.
OR Der logische Operator OR.
AND Der logische Operator AND.

DimensionFilter

Mit einem Dimensionsfilter werden die Filteroptionen für eine Dimension festgelegt.

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

string

Die Dimension, nach der gefiltert werden soll. Ein DimensionsFilter muss eine Dimension enthalten.

not

boolean

Logischer NOT-Operator. Wenn dieser boolesche Wert auf „true“ gesetzt ist, werden die übereinstimmenden Dimensionswerte aus dem Bericht ausgeschlossen. Der Standardwert ist "false".

operator

enum(Operator)

Hiermit wird die Dimension mit dem Ausdruck abgeglichen. Der Standardwert ist REGEXP.

expressions[]

string

Strings oder regulärer Ausdruck für den Abgleich Für den Vergleich wird nur der erste Wert der Liste verwendet, es sei denn, der Operator ist IN_LIST. Beim IN_LIST-Operator wird die gesamte Liste verwendet, um die Dimensionen zu filtern, wie in der Beschreibung des IN_LIST-Operators erläutert.

caseSensitive

boolean

Muss bei dem Abgleich zwischen Groß- und Kleinschreibung unterschieden werden? Der Standardwert ist "false".

Operator

Es werden unterschiedliche Keyword-Optionen unterstützt.

Enums
OPERATOR_UNSPECIFIED Wenn der Übereinstimmungstyp nicht angegeben ist, wird er als REGEXP behandelt.
REGEXP Der Übereinstimmungsausdruck wird als regulärer Ausdruck behandelt. Nicht alle Keyword-Optionen werden als reguläre Ausdrücke behandelt.
BEGINS_WITH Stimmt mit dem Wert überein, der mit dem angegebenen Übereinstimmungsausdruck beginnt.
ENDS_WITH Gleicht die Werte ab, die mit dem angegebenen Übereinstimmungsausdruck enden.
PARTIAL Teilstring-Übereinstimmung.
EXACT Der Wert sollte vollständig mit dem Übereinstimmungsausdruck übereinstimmen.
NUMERIC_EQUAL

Ganzzahlvergleichsfilter. Die Groß-/Kleinschreibung wird für diese Filter ignoriert und es wird angenommen, dass der Ausdruck ein String ist, der eine Ganzzahl darstellt. Fehlerbedingungen:

  • Wenn der Ausdruck kein gültiger int64-Wert ist, sollte der Client einen Fehler erwarten.
  • Eingabedimensionen, die keine gültigen int64-Werte sind, entsprechen niemals dem Filter.
NUMERIC_GREATER_THAN Überprüft, ob die Dimension numerisch größer als der Übereinstimmungsausdruck ist. Lies dir die Beschreibung von NUMERIC_EQUALS durch, um Informationen zu Einschränkungen zu erhalten.
NUMERIC_LESS_THAN Überprüft, ob die Dimension numerisch kleiner als der Übereinstimmungsausdruck ist. Lies dir die Beschreibung von NUMERIC_EQUALS durch, um Informationen zu Einschränkungen zu erhalten.
IN_LIST

Mit dieser Option wird ein Dimensionsfilter angegeben, dessen Ausdruck einen beliebigen Wert aus einer ausgewählten Werteliste annehmen kann. So vermeiden Sie, dass mehrere Dimensionsfilter vom Typ „Genau passend“ ausgewertet werden, die für jede einzelne Antwortzeile mit ODER verknüpft sind. Beispiel:

expressions: ["A", "B", "C"]

Jede Antwortzeile, deren Dimension den Wert A, B oder C hat, entspricht diesem DimensionsFilter.

Messwert

Messwerte sind die quantitativen Messungen. Der Messwert ga:users gibt beispielsweise die Gesamtzahl der Nutzer für den angeforderten Zeitraum an.

JSON-Darstellung 
{
  "expression": string,
  "alias": string,
  "formattingType": enum(MetricType)
}
Felder
expression

string

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

alias

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, sondern ein komplexer Ausdruck ist, der nicht zum Filtern und Sortieren verwendet werden kann. Der Alias wird auch in der Kopfzeile der Antwortspalte verwendet.

formattingType

enum(MetricType)

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

MetricType

Die Arten von Messwerten.

Enums
METRIC_TYPE_UNSPECIFIED Der Messwerttyp ist nicht angegeben.
INTEGER Ganzzahliger Messwert.
FLOAT Gleitkommawert.
CURRENCY Messwert „Währung“.
PERCENT Prozentsatz
TIME Zeitmesswert im Format HH:MM:SS.

MetricFilterClause

Stellt eine Gruppe von Messwertfiltern dar. Legen Sie den Operatorwert fest, um anzugeben, wie die Filter logisch kombiniert werden sollen.

JSON-Darstellung 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(MetricFilter)
    }
  ]
}
Felder
operator

enum(FilterLogicalOperator)

Der Operator zum Kombinieren mehrerer Messwertfilter. Wenn keine Angabe erfolgt, wird es als OR behandelt.

filters[]

object(MetricFilter)

Der wiederholte Satz von Filtern. Sie werden basierend auf dem angegebenen Operator logisch kombiniert.

MetricFilter

MetricFilter gibt den Filter für einen Messwert an.

JSON-Darstellung 
{
  "metricName": string,
  "not": boolean,
  "operator": enum(Operator),
  "comparisonValue": string
}
Felder
metricName

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 er kann auch ein Messwertausdruck sein.

not

boolean

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

operator

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. Der Vergleichswert wird ignoriert.

comparisonValue

string

Wert, mit dem verglichen werden soll

Operator

Verschiedene Vergleichstypen

Enums
OPERATOR_UNSPECIFIED Wenn der Operator nicht angegeben ist, wird er als EQUAL behandelt.
EQUAL Muss der Wert des Messwerts genau mit dem Vergleichswert übereinstimmen.
LESS_THAN Der Wert des Messwerts sollte kleiner als der Vergleichswert sein.
GREATER_THAN Gibt an, ob der Messwert größer als der Vergleichswert ist.
IS_MISSING Überprüft, ob der Messwert fehlt. Der Vergleichswert wird nicht berücksichtigt.

OrderBy

Gibt die Sortieroptionen an.

JSON-Darstellung 
{
  "fieldName": string,
  "orderType": enum(OrderType),
  "sortOrder": enum(SortOrder)
}
Felder
fieldName

string

Das Feld, nach dem sortiert werden soll. Die Standardsortierreihenfolge 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.

orderType

enum(OrderType)

Die Auftragsart. Der Standardwert für orderType ist VALUE.

sortOrder

enum(SortOrder)

Die Sortierreihenfolge für das Feld.

OrderType

OrderType steuert, wie die Sortierreihenfolge bestimmt wird.

Enums
ORDER_TYPE_UNSPECIFIED Wenn der Bestelltyp nicht angegeben ist, wird er wie eine Sortierung auf Grundlage des Werts behandelt.
VALUE Die Sortierreihenfolge basiert auf dem Wert der ausgewählten Spalte. Es wird nur der erste Zeitraum berücksichtigt.
DELTA Die Sortierreihenfolge basiert auf der Differenz der Werte der ausgewählten Spalte zwischen den ersten beiden Datumsbereichen. Kann nur verwendet werden, wenn es genau zwei Zeiträume gibt.
SMART Die Sortierreihenfolge basiert auf dem gewichteten Wert der ausgewählten Spalte. Wenn die Spalte das Format „n/d“ hat, ist der gewichtete Wert dieses Verhältnisses (n + totals.n)/(d + totals.d). Er kann nur für Messwerte verwendet werden, die Verhältnisse darstellen.
HISTOGRAM_BUCKET Der Typ der Histogrammreihenfolge gilt nur für Dimensionsspalten mit nicht leeren Histogramm-Buckets.
DIMENSION_AS_INTEGER Wenn es sich bei den Abmessungen um Zahlen mit fester Länge handelt, reicht eine gewöhnliche Sortierung aus. DIMENSION_AS_INTEGER kann verwendet werden, wenn die Abmessungen aus Zahlen mit variabler Länge bestehen.

SortOrder

Die Sortierreihenfolge der Sortierung.

Enums
SORT_ORDER_UNSPECIFIED Wenn keine Sortierreihenfolge angegeben ist, wird standardmäßig aufsteigend verwendet.
ASCENDING Aufsteigend. Das Feld wird aufsteigend sortiert.
DESCENDING Absteigende Sortierung. Das Feld wird absteigend sortiert.

Segment

Die Segmentdefinition, wenn der Bericht segmentiert werden muss Ein Segment ist eine Teilmenge der Analytics-Daten. Beispielsweise könnten Nutzer aus einem bestimmten Land oder einer bestimmten Stadt ein Segment aller Nutzer sein.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld dynamicOrById. Das Segment kann dynamisch über DynamicSegment oder über die ID eines integrierten oder benutzerdefinierten Segments definiert werden. Für dynamicOrById ist nur einer der folgenden Werte zulässig:
dynamicSegment

object(DynamicSegment)

Eine dynamische Segmentdefinition in der Anfrage.

segmentId

string

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

DynamicSegment

Dynamische Segmentdefinition zum Definieren des Segments in der Anfrage Für ein Segment können Nutzer, Sitzungen oder beides ausgewählt werden.

JSON-Darstellung 
{
  "name": string,
  "userSegment": {
    object(SegmentDefinition)
  },
  "sessionSegment": {
    object(SegmentDefinition)
  }
}
Felder
name

string

Der Name des dynamischen Segments.

userSegment

object(SegmentDefinition)

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

sessionSegment

object(SegmentDefinition)

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

SegmentDefinition

SegmentDefinition definiert ein Segment als ein Satz von SegmentFilters, die mit einer logischen AND-Operation kombiniert werden.

JSON-Darstellung 
{
  "segmentFilters": [
    {
      object(SegmentFilter)
    }
  ]
}
Felder
segmentFilters[]

object(SegmentFilter)

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

SegmentFilter

SegmentFilter definiert, ob das Segment entweder ein einfaches Segment oder ein Sequenzsegment ist. Eine einfache Segmentbedingung enthält Dimensions- und Messwertbedingungen zur Auswahl der Sitzungen oder Nutzer. Eine Bedingung für ein Sequenzsegment kann verwendet werden, um Nutzer oder Sitzungen basierend auf sequenziellen Bedingungen auszuwählen.

JSON-Darstellung 
{
  "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.
}
Felder
not

boolean

Bei „true“ wird die Ergänzung des einfachen oder Sequenzsegments abgeglichen. Um beispielsweise alle Besuche abzugleichen, die nicht von „New York“ stammen, können wir das Segment wie folgt definieren:

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

Union-Feld simpleOrSequence. Handelt es sich um ein einfaches Segment oder eine Sequenzsegmentdefinition? Für simpleOrSequence ist nur einer der folgenden Werte zulässig:
simpleSegment

object(SimpleSegment)

Einfache Segmentbedingungen bestehen aus mindestens einer Dimensions-/Messwertbedingung, die kombiniert werden kann

sequenceSegment

object(SequenceSegment)

Sequenzbedingungen bestehen aus einem oder mehreren Schritten, wobei jeder Schritt durch eine oder mehrere Dimensions- oder Messwertbedingungen definiert ist. Mehrere Schritte können mit speziellen Sequenzoperatoren kombiniert werden.

SimpleSegment

Einfache Segmentbedingungen bestehen aus mindestens einer Dimensions- oder Messwertbedingung, die kombiniert werden kann.

JSON-Darstellung 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ]
}
Felder
orFiltersForSegment[]

object(OrFiltersForSegment)

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

OrFiltersForSegment

Eine Liste der Segmentfilter in der Gruppe OR wird mit dem logischen ODER-Operator kombiniert.

JSON-Darstellung 
{
  "segmentFilterClauses": [
    {
      object(SegmentFilterClause)
    }
  ]
}
Felder
segmentFilterClauses[]

object(SegmentFilterClause)

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

SegmentFilterClause

Die in einer Segmentdefinition zu verwendende Filterklausel kann entweder ein Messwert oder ein Dimensionsfilter sein.

JSON-Darstellung 
{
  "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.
}
Felder
not

boolean

Stimmt mit der Ergänzung (!) des Filters überein.

Union-Feld dimensionOrMetricFilter. Dimension oder Messwertfilter. Für dimensionOrMetricFilter ist nur einer der folgenden Werte zulässig:
dimensionFilter

object(SegmentDimensionFilter)

Dimensionsfilter für die Segmentdefinition.

metricFilter

object(SegmentMetricFilter)

Messwertfilter für die Segmentdefinition.

SegmentDimensionFilter

Mit einem Dimensionsfilter werden die Filteroptionen für eine Dimension festgelegt.

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

string

Name der Dimension, auf die der Filter angewendet wird.

operator

enum(Operator)

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

caseSensitive

boolean

Bei Übereinstimmung muss die Groß-/Kleinschreibung beachtet werden. Wird beim Operator IN_LIST ignoriert.

expressions[]

string

Liste der Ausdrücke – nur das erste Element wird für alle Operatoren verwendet

minComparisonValue

string

Minimale Vergleichswerte für BETWEEN Keyword-Option.

maxComparisonValue

string

Maximale Vergleichswerte für Keyword-Option BETWEEN.

Operator

Es werden unterschiedliche Keyword-Optionen unterstützt.

Enums
OPERATOR_UNSPECIFIED Wenn der Übereinstimmungstyp nicht angegeben ist, wird er als REGEXP behandelt.
REGEXP Der Übereinstimmungsausdruck wird als regulärer Ausdruck behandelt. Alle anderen Keyword-Optionen werden nicht als reguläre Ausdrücke behandelt.
BEGINS_WITH Gleicht die Werte ab, die mit dem angegebenen Übereinstimmungsausdruck beginnen.
ENDS_WITH Gleicht die Werte ab, die mit dem angegebenen Übereinstimmungsausdruck enden.
PARTIAL Teilstring-Übereinstimmung.
EXACT Der Wert sollte vollständig mit dem Übereinstimmungsausdruck übereinstimmen.
IN_LIST

Mit dieser Option wird ein Dimensionsfilter angegeben, dessen Ausdruck einen beliebigen Wert aus einer ausgewählten Werteliste annehmen kann. So vermeiden Sie, dass mehrere Dimensionsfilter vom Typ „Genau passend“ ausgewertet werden, die für jede einzelne Antwortzeile mit ODER verknüpft sind. Beispiel:

expressions: ["A", "B", "C"]

Jede Antwortzeile, deren Dimension den Wert A, B oder C hat, entspricht diesem DimensionsFilter.
NUMERIC_LESS_THAN

Ganzzahlvergleichsfilter. Die Groß-/Kleinschreibung wird für diese Filter ignoriert und es wird angenommen, dass der Ausdruck ein String ist, der eine Ganzzahl darstellt. Fehlerbedingungen:

  • Wenn der Ausdruck kein gültiger int64-Wert ist, sollte der Client einen Fehler erwarten.
  • Eingabedimensionen, die keine gültigen int64-Werte sind, entsprechen niemals dem Filter.

Überprüft, ob die Dimension numerisch kleiner als der Übereinstimmungsausdruck ist.
NUMERIC_GREATER_THAN Überprüft, ob die Dimension numerisch größer als der Übereinstimmungsausdruck ist.
NUMERIC_BETWEEN Überprüft, ob die Dimension numerisch zwischen dem Minimum und dem Maximum des Übereinstimmungsausdrucks liegt, wobei Grenzen ausgeschlossen sind.

SegmentMetricFilter

Messwertfilter, der in einer Segmentfilterklausel verwendet werden soll.

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

enum(Scope)

Der Umfang eines Messwerts bestimmt, auf welcher Ebene er definiert wird. Der angegebene Messwertumfang muss mindestens dem primären Bereich entsprechen, der im Datenmodell definiert ist. Der primäre Umfang wird dadurch bestimmt, ob das Segment Nutzer oder Sitzungen auswählt.

metricName

string

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

operator

enum(Operator)

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

comparisonValue

string

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

maxComparisonValue

string

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

Bereich

Der Umfang eines Messwerts definiert die Ebene, auf der der Messwert definiert ist: PRODUCT, HIT, SESSION oder USER. Messwerte können auch in Bereichen gemeldet werden, die größer als der primäre Bereich sind. Beispiel: ga:pageviews und ga:transactions können auf SESSION- und USER-Ebene erfasst werden. Dazu werden sie für jeden Treffer in diesen Sitzungen oder für diese Nutzer addiert.

Enums
UNSPECIFIED_SCOPE Wenn kein Umfang angegeben ist, wird standardmäßig der Bedingungsbereich USER oder SESSION verwendet, je nachdem, ob mit dem Segment Nutzer oder Sitzungen ausgewählt werden sollen.
PRODUCT Produktumfang.
HIT Trefferbereich.
SESSION Sitzungsumfang.
USER Nutzerumfang.

Operator

Verschiedene Vergleichstypen

Enums
UNSPECIFIED_OPERATOR Ein nicht angegebener Operator wird als Operator LESS_THAN behandelt.
LESS_THAN Überprüft, ob der Messwert kleiner als der Vergleichswert ist.
GREATER_THAN Überprüft, ob der Messwert größer als der Vergleichswert ist.
EQUAL Ist-Operator.
BETWEEN Beim Operator „zwischen“ sind sowohl das Minimum als auch das Maximum ausgeschlossen. Zum Vergleich verwenden wir LT und GT.

SequenceSegment

Sequenzbedingungen bestehen aus einem oder mehreren Schritten, wobei jeder Schritt durch eine oder mehrere Dimensions- oder Messwertbedingungen definiert ist. Mehrere Schritte können mit speziellen Sequenzoperatoren kombiniert werden.

JSON-Darstellung 
{
  "segmentSequenceSteps": [
    {
      object(SegmentSequenceStep)
    }
  ],
  "firstStepShouldMatchFirstHit": boolean
}
Felder
segmentSequenceSteps[]

object(SegmentSequenceStep)

Die Liste der Schritte in der Sequenz.

firstStepShouldMatchFirstHit

boolean

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

SegmentSequenceStep

Eine Definition der Segmentsequenz.

JSON-Darstellung 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ],
  "matchType": enum(MatchType)
}
Felder
orFiltersForSegment[]

object(OrFiltersForSegment)

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

matchType

enum(MatchType)

Gibt an, ob der Schritt dem nächsten Schritt unmittelbar vorausgeht oder ein beliebiger Zeitpunkt davor sein kann.

MatchType

Die Keyword-Option für die Sequenz.

Enums
UNSPECIFIED_MATCH_TYPE Eine nicht angegebene Keyword-Option wird als vorangestellt behandelt.
PRECEDES Der Operator gibt an, dass der vorherige Schritt dem nächsten Schritt vorausgeht.
IMMEDIATELY_PRECEDES Der Operator gibt an, dass der vorherige Schritt dem nächsten Schritt unmittelbar vorausgeht.

Pivot ausführen

Der Pivot beschreibt den Pivot-Abschnitt in der Anfrage. Mithilfe der Pivot-Funktion können Sie die Informationen in der Tabelle für bestimmte Berichte neu anordnen, indem Ihre Daten in einer zweiten Dimension neu angeordnet werden.

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

object(Dimension)

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

dimensionFilterClauses[]

object(DimensionFilterClause)

DimensionFilterClauses werden logisch mit einem AND-Operator kombiniert: Nur die Daten, die von all diesen DimensionFilterClauses stammen, werden zu den Werten in dieser Pivot-Region beitragen. Mit Dimensionsfiltern können die im Pivot-Bereich angezeigten Spalten eingeschränkt werden. Wenn beispielsweise ga:browser die angeforderte Dimension in der Pivot-Region ist und Sie Schlüsselfilter angeben, um ga:browser auf „IE“ oder „Firefox“ zu beschränken, werden nur diese beiden Browser als Spalten angezeigt.

metrics[]

object(Metric)

Die Pivot-Messwerte. Pivot-Messwerte sind Teil der Einschränkung der Gesamtzahl der in der Anfrage zulässigen Messwerte.

startGroup

number

Wenn k Messwerte angefordert wurden, enthält die Antwort ein datenabhängiges Vielfaches von k Spalten im Bericht. Wenn Sie beispielsweise ein Drehpunkt auf die Dimension ga:browser festgelegt haben, erhalten Sie k Spalten für „Firefox“, k Spalten für „IE“, k Spalten für „Chrome“ usw. Die Reihenfolge der Spaltengruppen wird durch die absteigende Reihenfolge von „total“ für den ersten der k Werte bestimmt. Die Bindungen werden durch die lexikografische Reihenfolge der ersten Pivot-Dimension, dann die lexikografische Reihenfolge der zweiten Pivot-Dimension usw. aufgelöst. Beispiel: Wenn die Summen für den ersten Wert für Firefox, IE und Chrome jeweils 8, 2 und 8 betragen, werden die Spalten Chrome, Firefox, IE sortiert.

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

number

Gibt die maximale Anzahl von Gruppen an, die zurückgegeben werden sollen. Der Standardwert ist 10, der Maximalwert ist 1.000.

CohortGroup

Definiert eine Kohortengruppe. Beispiel:

"cohortGroup": {
  "cohorts": [{
    "name": "cohort 1",
    "type": "FIRST_VISIT_DATE",
    "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
  },{
    "name": "cohort 2"
     "type": "FIRST_VISIT_DATE"
     "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
  }]
}
JSON-Darstellung 
{
  "cohorts": [
    {
      object(Cohort)
    }
  ],
  "lifetimeValue": boolean
}
Felder
cohorts[]

object(Cohort)

Die Definition für die Kohorte.

lifetimeValue

boolean

Lifetime-Wert (LTV) aktivieren Der LTV misst den Lifetime-Wert für Nutzer, die über verschiedene Kanäle gewonnen wurden. Weitere Informationen finden Sie unter Kohortenanalyse und Lifetime-Wert, wenn der Lifetime-Wert falsch ist:

  • Die Messwerte ähneln den Werten im Kohortenbericht der Weboberfläche.
  • Die Zeiträume der Kohortendefinition müssen auf die Kalenderwoche und den Monat ausgerichtet sein. Wenn Sie also ga:cohortNthWeek anfordern, sollte der startDate in der Kohortendefinition ein Sonntag und die endDate auf den folgenden Samstag und für ga:cohortNthMonth der startDate der erste Tag des Monats und endDate der letzte Tag des Monats sein.

Wenn der „LifetimeValue“ wahr ist:

  • Die Messwerte entsprechen den Werten im Lifetime-Wert-Bericht der Weboberfläche.
  • Im Bericht „Lifetime-Wert“ sehen Sie, wie der Nutzerwert (Umsatz) und die Interaktion (App-Aufrufe, Abschlüsse für Zielvorhaben, Sitzungen und Sitzungsdauer) in den 90 Tagen nach der Akquisition eines Nutzers wachsen.
  • Die Messwerte werden als kumulativer Durchschnitt pro Nutzer im Zeitabschnitt berechnet.
  • Die Zeiträume der Kohortendefinition müssen nicht auf die Kalenderwochen und -monate ausgerichtet sein.
  • Die viewId muss eine App-Datenansicht-ID sein

Cohort

Definiert eine Kohorte. Eine Kohorte ist eine Gruppe von Nutzenden mit einem gemeinsamen Merkmal. Beispielsweise gehören alle Nutzer mit demselben Akquisitionsdatum zur selben Kohorte.

JSON-Darstellung 
{
  "name": string,
  "type": enum(Type),
  "dateRange": {
    object(DateRange)
  }
}
Felder
name

string

Ein eindeutiger Name für die Kohorte. Wenn kein Name festgelegt ist, wird er automatisch mit den Werten „Kohorte_[1234...]“ generiert.

type

enum(Type)

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

dateRange

object(DateRange)

Wird für die Kohorte „FIRST_VISIT_DATE“ verwendet. Dabei werden Nutzer ausgewählt, deren Datum des ersten Besuchs zwischen dem im „DateRange“ festgelegten Start- und Enddatum liegt. Die Zeiträume sollten für Kohortenanfragen angeglichen werden. Wenn die Anfrage ga:cohortNthDay enthält, sollte sie genau einen Tag lang sein. Bei ga:cohortNthWeek soll sie an der Wochengrenze ausgerichtet werden (beginnend am Sonntag und endet am Samstag) und für ga:cohortNthMonth sollte der Zeitraum auf den Monat ausgerichtet werden (beginnend am ersten und endet am letzten Tag des Monats). Für LTV-Anfragen gibt es keine solchen Einschränkungen. Für das Feld reportsRequest.dateRanges muss kein Zeitraum angegeben werden.

Typ

Kohortentyp

Enums
UNSPECIFIED_COHORT_TYPE Wenn keine Vorgabe erfolgt, wird sie als FIRST_VISIT_DATE behandelt.
FIRST_VISIT_DATE Kohorten, die auf Grundlage des Datums des ersten Besuchs ausgewählt werden.

Melden

Die Datenantwort, die der Anfrage entspricht.

JSON-Darstellung 
{
  "columnHeader": {
    object(ColumnHeader)
  },
  "data": {
    object(ReportData)
  },
  "nextPageToken": string
}
Felder
columnHeader

object(ColumnHeader)

Die Spaltenüberschriften.

data

object(ReportData)

Antwortdaten.

nextPageToken

string

Seitentoken zum Abrufen der nächsten Seite mit Ergebnissen in der Liste.

ColumnHeader

Spaltenüberschriften.

JSON-Darstellung 
{
  "dimensions": [
    string
  ],
  "metricHeader": {
    object(MetricHeader)
  }
}
Felder
dimensions[]

string

Die Dimensionsnamen in der Antwort.

metricHeader

object(MetricHeader)

Messwertheader für die Messwerte in der Antwort.

MetricHeader

Die Überschriften für die Messwerte.

JSON-Darstellung 
{
  "metricHeaderEntries": [
    {
      object(MetricHeaderEntry)
    }
  ],
  "pivotHeaders": [
    {
      object(PivotHeader)
    }
  ]
}
Felder
metricHeaderEntries[]

object(MetricHeaderEntry)

Header für die Messwerte in der Antwort.

pivotHeaders[]

object(PivotHeader)

Header für die Pivots in der Antwort.

MetricHeaderEntry

Überschrift für die Messwerte.

JSON-Darstellung 
{
  "name": string,
  "type": enum(MetricType)
}
Felder
name

string

Der Name des Headers.

type

enum(MetricType)

Der Typ des Messwerts, z. B. INTEGER.

PivotHeader

Die Header für jeden der in der Anfrage definierten Pivot-Abschnitte.

JSON-Darstellung 
{
  "pivotHeaderEntries": [
    {
      object(PivotHeaderEntry)
    }
  ],
  "totalPivotGroupsCount": number
}
Felder
pivotHeaderEntries[]

object(PivotHeaderEntry)

Eine einzelne Pivot-Abschnittsüberschrift.

totalPivotGroupsCount

number

Die Gesamtzahl der Gruppen für diesen Pivot.

PivotHeaderEntry

Die Überschriften für die einzelnen Messwertspalten, die den im Pivots-Bereich der Antwort angeforderten Messwerten entsprechen.

JSON-Darstellung 
{
  "dimensionNames": [
    string
  ],
  "dimensionValues": [
    string
  ],
  "metric": {
    object(MetricHeaderEntry)
  }
}
Felder
dimensionNames[]

string

Der Name der Dimensionen in der Pivot-Antwort.

dimensionValues[]

string

Die Werte für die Dimensionen im Pivot.

metric

object(MetricHeaderEntry)

Messwertüberschrift für den Messwert im Pivot.

ReportData

Der Datenteil des Berichts.

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

object(ReportRow)

Für jede eindeutige Kombination von Dimensionen gibt es eine ReportRow.

totals[]

object(DateRangeValues)

Für jeden angeforderten Zeitraum erhält jedes angeforderte Werteformat aus allen Zeilen, die mit der Abfrage übereinstimmen, eine Gesamtsumme. Die Gesamtsumme für ein Wertformat wird berechnet, indem zuerst die im Wertformat erwähnten Messwerte summiert und dann das Wertformat als skalarer Ausdruck ausgewertet wird. Beispiel: In den „Gesamtsummen“ für 3 / (ga:sessions + 2) wird 3 / ((sum of all relevant ga:sessions) + 2) berechnet. Die Gesamtsummen werden vor der Paginierung berechnet.

rowCount

number

Gesamtzahl der übereinstimmenden Zeilen für diese Abfrage.

minimums[]

object(DateRangeValues)

Minimal- und Maximalwerte, die in allen übereinstimmenden Zeilen angezeigt werden. Beide sind leer, wenn hideValueRanges in der Anfrage „false“ ist oder wenn rowCount null ist.

maximums[]

object(DateRangeValues)

Minimal- und Maximalwerte, die in allen übereinstimmenden Zeilen angezeigt werden. Beide sind leer, wenn hideValueRanges in der Anfrage „false“ ist oder wenn rowCount null ist.

samplesReadCounts[]

string (int64 format)

Wenn die Ergebnisse Stichproben sind, wird die Gesamtzahl der gelesenen Stichproben zurückgegeben, ein Eintrag pro Zeitraum. Wenn die Ergebnisse nicht auf Stichproben basieren, wird dieses Feld nicht definiert. Weitere Informationen finden Sie im Entwicklerleitfaden.

samplingSpaceSizes[]

string (int64 format)

Handelt es sich um Stichproben, wird die Gesamtzahl der vorhandenen Stichproben mit einem Eintrag pro Zeitraum zurückgegeben. Wenn die Ergebnisse nicht auf Stichproben basieren, wird dieses Feld nicht definiert. Weitere Informationen finden Sie im Entwicklerleitfaden.

isDataGolden

boolean

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

dataLastRefreshed

string (Timestamp format)

Der Zeitpunkt, zu dem die Daten im Bericht zuletzt aktualisiert wurden. Alle Treffer vor diesem Zeitstempel werden in die Berechnung des Berichts einbezogen.

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

ReportRow

Eine Zeile im Bericht.

JSON-Darstellung 
{
  "dimensions": [
    string
  ],
  "metrics": [
    {
      object(DateRangeValues)
    }
  ]
}
Felder
dimensions[]

string

Liste der angeforderten Dimensionen.

metrics[]

object(DateRangeValues)

Liste der Messwerte für jeden angeforderten DateRange.

DateRangeValues

Wird verwendet, um eine Liste von Messwerten für eine einzelne Kombination aus Datumsbereich und Dimension zurückzugeben

JSON-Darstellung 
{
  "values": [
    string
  ],
  "pivotValueRegions": [
    {
      object(PivotValueRegion)
    }
  ]
}
Felder
values[]

string

Jeder Wert entspricht jedem Messwert in der Anfrage.

pivotValueRegions[]

object(PivotValueRegion)

Die Werte der einzelnen Pivot-Regionen.

PivotValueRegion

Die Messwerte in der Pivot-Region.

JSON-Darstellung 
{
  "values": [
    string
  ]
}
Felder
values[]

string

Die Werte der Messwerte in jeder Pivot-Region.

ResourceQuotasRemaining

Die Ressourcenkontingenttokens, die nach Abschluss der Anfrage für das Attribut verbleiben.

JSON-Darstellung 
{
  "dailyQuotaTokensRemaining": number,
  "hourlyQuotaTokensRemaining": number
}
Felder
dailyQuotaTokensRemaining

number

Verbleibendes Tageskontingent für Ressourcen.

hourlyQuotaTokensRemaining

number

Verbleibende Tokens für stündliche Ressourcenkontingente.

Jetzt testen