- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ResponseMetaData
- SchemaRestrictionResponse
- ActiveMetricRestriction
- RestrictedMetricType
- Testen!
Ruft den Inhalt einer Berichtsaufgabe ab. Nachdem Sie die reportTasks.create
angefordert haben, können Sie den Berichtsinhalt abrufen, sobald der Bericht AKTIV ist. Diese Methode gibt einen Fehler zurück, wenn der Status der Berichtsaufgabe nicht ACTIVE
ist. Eine Abfrageantwort gibt die tabellarischen Zeilen- und Spaltenwerte des Berichts zurück.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
name |
Erforderlich. Der Name der Berichtsquelle. Format: |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "offset": string, "limit": string } |
Felder | |
---|---|
offset |
Optional. Die Zeilenanzahl der Startzeile im Bericht. Die erste Zeile wird als Zeile 0 gezählt. Beim Paging wird in der ersten Anfrage kein „offset“ angegeben oder entsprechend „offset“ auf 0. Die erste Anfrage gibt die erste Weitere Informationen zu diesem Parameter finden Sie unter Paginierung. |
limit |
Optional. Die Anzahl der Zeilen, die aus dem Bericht zurückgegeben werden sollen. Wenn kein Wert angegeben ist, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen Sie anfordern. Die API kann auch weniger Zeilen als vom angeforderten Weitere Informationen zu diesem Parameter finden Sie unter Paginierung. |
Antworttext
Der Berichtinhalt, der einer Berichtsaufgabe entspricht.
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "dimensionHeaders": [ { object ( |
Felder | |
---|---|
dimensionHeaders[] |
Beschreibt Dimensionsspalten. Die Anzahl der DimensionHeaders und die Reihenfolge der DimensionHeaders entsprechen den Dimensionen in den Zeilen. |
metricHeaders[] |
Beschreibt Messwertspalten. Die Anzahl der MetricHeaders und die Reihenfolge der MetricHeaders entsprechen den Messwerten in den Zeilen. |
rows[] |
Zeilen mit Dimensionswertkombinationen und Messwerten im Bericht. |
totals[] |
Falls angefordert, die Gesamtwerte der Messwerte. |
maximums[] |
Falls angefordert, die Maximalwerte von Messwerten. |
minimums[] |
Falls angefordert, die Mindestwerte von Messwerten. |
rowCount |
Die Gesamtzahl der Zeilen im Abfrageergebniss. |
metadata |
Metadaten für den Bericht. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ResponseMetaData
Die Metadaten der Antwort, die zusätzliche Informationen zum Inhalt des Berichts enthalten.
JSON-Darstellung |
---|
{
"dataLossFromOtherRow": boolean,
"schemaRestrictionResponse": {
object ( |
Felder | |
---|---|
dataLossFromOtherRow |
Bei „true“ werden einige Gruppen von Dimensionskombinationen in die Zeile „Sonstiges“ zusammengefasst. Das kann bei Berichten mit hoher Kardinalität passieren. Der Metadatenparameter „dataLossFromOtherRow“ wird basierend auf der im Bericht verwendeten aggregierten Datentabelle ausgefüllt. Der Parameter wird unabhängig von den Filtern und Beschränkungen im Bericht korrekt ausgefüllt. Beispielsweise kann die Zeile „Sonstiges“ aus dem Bericht entfernt werden, weil die Anfrage einen Filter für „sessionSource = google“ enthält. Dieser Parameter wird weiterhin ausgefüllt, wenn in den aggregierten Eingabedaten, die zum Generieren dieses Berichts verwendet wurden, ein Datenverlust aus einer anderen Zeile aufgetreten ist. Weitere Informationen zur Zeile „Sonstiges“ und zur Stichprobenerhebung |
schemaRestrictionResponse |
Beschreibt die Schemaeinschränkungen, die beim Erstellen dieses Berichts aktiv erzwungen werden. Weitere Informationen finden Sie unter Verwaltung von Zugriffs- und Dateneinschränkungen. |
currencyCode |
Der in diesem Bericht verwendete Währungscode. Zur Visualisierung zur Formatierung von Währungsmesswerten wie Währungscodes sind Zeichenfolgencodierungen von Währungstypen aus dem ISO-4217-Standard (https://en.wikipedia.org/wiki/ISO_4217), z. B. „EUR“, „EUR“, „JPY“. Weitere Informationen finden Sie unter https://support.google.com/analytics/answer/9796179. |
timeZone |
Die aktuelle Zeitzone der Unterkunft. Zur Interpretation zeitbasierter Dimensionen wie |
emptyReason |
Wird kein Grund angegeben, ist der Bericht aus diesem Grund leer. |
subjectToThresholding |
Wenn |
SchemaRestrictionResponse
Die Schemaeinschränkungen, die beim Erstellen dieses Berichts aktiv erzwungen werden. Weitere Informationen finden Sie unter Verwaltung von Zugriffs- und Dateneinschränkungen.
JSON-Darstellung |
---|
{
"activeMetricRestrictions": [
{
object ( |
Felder | |
---|---|
activeMetricRestrictions[] |
Alle Einschränkungen beim Erstellen des Berichts werden aktiv erzwungen. |
ActiveMetricRestriction
Ein Messwert, der beim Erstellen des Berichts aktiv eingeschränkt ist.
JSON-Darstellung |
---|
{
"restrictedMetricTypes": [
enum ( |
Felder | |
---|---|
restrictedMetricTypes[] |
Der Grund für die Einschränkung dieses Messwerts. |
metricName |
Der Name des eingeschränkten Messwerts. |
RestrictedMetricType
Datenkategorien, die in bestimmten GA4-Properties möglicherweise nicht aufgerufen werden können
Enums | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Nicht definierter Typ. |
COST_DATA |
Kostenmesswerte wie adCost . |
REVENUE_DATA |
Umsatzmesswerte wie purchaseRevenue . |