- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ResponseMetaData
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SchemaRestrictionResponse
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ActiveMetricRestriction
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- 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 tabellarische Zeile und Spaltenwerte des Berichts.
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 mit der ersten Anfrage kein Offset angegeben. oder entsprechend setzt Offset auf 0; Die erste Anfrage gibt die ersten Weitere Informationen zu diesem Paginierungsparameter finden Sie unter Paginierung. |
limit |
Optional. Die Anzahl der Zeilen, die aus dem Bericht zurückgegeben werden sollen. Wenn nicht angegeben, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen angefordert werden. Die API kann auch weniger Zeilen als die angeforderte Weitere Informationen zu diesem Paginierungsparameter finden Sie unter Paginierung. |
Antworttext
Der Berichtsinhalt, der einer Berichtsaufgabe entspricht.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "dimensionHeaders": [ { object ( |
Felder | |
---|---|
dimensionHeaders[] |
Beschreibt Dimensionsspalten. Die Anzahl der DimensionHeaders und die Reihenfolge von 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[] |
Auf Anfrage die Gesamtwerte der Messwerte. |
maximums[] |
Auf Anfrage die Maximalwerte der Messwerte. |
minimums[] |
Bei Bedarf die Mindestwerte für Messwerte. |
rowCount |
Die Gesamtzahl der Zeilen im Abfrageergebnis. |
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 mit zusätzlichen Informationen zum Inhalt des Berichts.
JSON-Darstellung |
---|
{
"dataLossFromOtherRow": boolean,
"schemaRestrictionResponse": {
object ( |
Felder | |
---|---|
dataLossFromOtherRow |
Falls wahr, werden einige Gruppen von Dimensionskombinationen in „Sonstiges“ zusammengefasst. Zeile. Das kann bei Berichten mit hoher Kardinalität vorkommen. Der Metadatenparameter dataLossFromOtherRow wird basierend auf der im Bericht verwendeten aggregierten Datentabelle ausgefüllt. Der Parameter wird unabhängig von den Filtern und Grenzwerten im Bericht korrekt ausgefüllt. Beispielsweise könnte die Zeile „Sonstiges“ aus dem Bericht entfernt werden, weil die Anfrage einen Filter für sessionSource = google. Dieser Parameter wird weiterhin gefüllt, wenn in den aggregierten Eingabedaten, die zum Generieren dieses Berichts verwendet werden, Datenverluste aus anderen Zeilen aufgetreten sind. 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. Vorgesehen zur Formatierung von Währungsmesswerten wie Währungscodes sind Stringcodierungen von Währungstypen aus dem ISO-Standard 4217 (https://en.wikipedia.org/wiki/ISO_4217). Beispiel: „USD“, „EUR“, „JPY“. Weitere Informationen finden Sie unter https://support.google.com/analytics/answer/9796179. |
timeZone |
Die aktuelle Zeitzone der Unterkunft. Wird zur Interpretation zeitbasierter Dimensionen wie |
emptyReason |
Wenn ein leerer Grund angegeben wird, 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 werden beim Erstellen des Berichts aktiv erzwungen. Beispielsweise hat |
ActiveMetricRestriction
Ein Messwert, der beim Erstellen des Berichts aktiv eingeschränkt wurde.
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 angezeigt werden können.
Enums | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Nicht definierter Typ. |
COST_DATA |
Kostenmesswerte wie adCost . |
REVENUE_DATA |
Umsatzmesswerte wie purchaseRevenue . |