Für die Data API gelten die folgenden Limits und Kontingente.
Anwendung von Kontingenten
Für alle Anfragen an die Google Analytics Data API v1 ist ein Google Cloud-Projekt erforderlich. Außerdem gelten die auf dieser Seite beschriebenen Kontingente. Kontingente werden unabhängig von der Methode verbraucht, die zum Identifizieren des aufrufenden Projekts verwendet wird, einschließlich:
- Anfragen, die mit OAuth 2.0-Anmeldedaten authentifiziert wurden
- Anfragen, die nur mit einem API-Schlüssel authentifiziert wurden
API-Schlüssel werden verwendet, um eine Anfrage zu Kontingent- und Abrechnungszwecken mit einem bestimmten Google Cloud-Projekt zu verknüpfen. Alle API-Aufrufe, die mit Anmeldedaten oder einem API-Schlüssel aus Ihrem Projekt erfolgen, werden auf die entsprechenden Kontingente Ihres Projekts und der Google Analytics-Property angerechnet.
Kontingentkategorien
Die Data API hat drei Kategorien für Anfragekontingente: „Kern-“, „Echtzeit“ und „Trichter“. Für API-Anfragen an Kernmethoden werden Kernkontingente berechnet. Für API-Anfragen an Echtzeitmethoden werden Echtzeitkontingente berechnet. Für jede Anfrage wird nur eine Art von Kontingent verbraucht.
| Kontingentkategorie | API-Methoden |
|---|---|
| Kern- | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| Echtzeit | runRealtimeReport |
| Trichter | runFunnelReport |
Kontingente für Analytics-Properties
Für alle Anfragen werden Property-Kontingente verbraucht.
| Kontingentname | Standardlimit für Properties | Limit für Analytics 360-Properties |
|---|---|---|
| Kern-Tokens pro Property und Tag | 200.000 | 2.000.000 |
| Kern-Tokens pro Property und Stunde | 40.000 | 400.000 |
| Kern-Tokens pro Projekt, Property und Stunde | 14.000 | 140.000 |
| Gleichzeitige Kern-Anfragen pro Property | 10 | 50 |
| Kern-Serverfehler pro Projekt, Property und Stunde | 10 | 50 |
| Echtzeit-Tokens pro Property und Tag | 200.000 | 2.000.000 |
| Echtzeit-Tokens pro Property und Stunde | 40.000 | 400.000 |
| Echtzeit-Tokens pro Projekt, Property und Stunde | 14.000 | 140.000 |
| Gleichzeitige Echtzeit-Anfragen pro Property | 10 | 50 |
| Echtzeit-Serverfehler pro Projekt, Property und Stunde | 10 | 50 |
| Trichter-Tokens pro Property und Tag | 200.000 | 2.000.000 |
| Trichter-Tokens pro Property und Stunde | 40.000 | 400.000 |
| Trichter-Tokens pro Projekt, Property und Stunde | 14.000 | 140.000 |
| Gleichzeitige Trichter-Anfragen pro Property | 10 | 50 |
| Trichter-Serverfehler pro Projekt, Property und Stunde | 10 | 50 |
- Gleichzeitige Anfragen werden anhand der Anzahl der Anfragen gemessen, die gleichzeitig ausgeführt werden. Wenn Sie die Anzahl gleichzeitiger Anfragen reduzieren möchten, warten Sie, bis vorherige Anfragen abgeschlossen sind, bevor Sie weitere Anfragen senden.
- Serverfehler sind die Codes 500 und 503. Kontingente für Serverfehler werden nur berechnet, wenn eine Anfrage zu einem Serverfehler führt. Wenn die Kontingente für Serverfehler für ein Projekt- und Property-Paar ausgeschöpft sind, werden alle Anfragen an die Property aus dem Projekt blockiert. Eine vollständige Liste der Fehlerantworten finden Sie unter Fehlerantworten.
- Für jede Anfrage wird das Kontingent für „Tokens pro Property und Stunde“ und „Tokens pro Projekt, Property und Stunde“ verbraucht. Das bedeutet, dass auf eine Property von mehr als drei Projekten zugegriffen werden muss, bevor das Kontingent „Tokens pro Property und Stunde“ vor dem Kontingent „Tokens pro Projekt, Property und Stunde“ ausgeschöpft sein kann.
Für Properties sind 120 potenziell mit Grenzwerten versehene Anfragen pro Stunde zulässig. Die Dimensionen userAgeBracket, userGender, brandingInterest, audienceId und audienceName sind potenziell mit Grenzwerten versehen. Grenzwerte sollen verhindern, dass ein Betrachter eines Berichts Rückschlüsse auf demografische Merkmale oder Interessen eines bestimmten Nutzers ziehen kann.
Kontingent für Property-Tokens
Bei jeder Anfrage an die Google Analytics Data API v1 werden Tokens verbraucht. Die Anzahl der berechneten Tokens hängt von der Komplexität der Anfrage ab. Bei den meisten Anfragen werden 10 oder weniger Tokens berechnet, bei komplexeren Anfragen mehr.
Faktoren, die den Tokenverbrauch beeinflussen
Die genauen Tokenkosten für eine Anfrage werden zum Zeitpunkt der Ausführung ermittelt, was eine genaue Vorabberechnung erschwert. Die Kosten werden durch eine Kombination von Faktoren beeinflusst, die sich auf die Anfrage selbst und die zugrunde liegenden Daten in der Google Analytics-Property beziehen. Diese Faktoren können zu höheren Kosten führen:
- Anzahl der Zeilen:Anfordern einer größeren Anzahl von Zeilen
- Anzahl der Dimensionen und Messwerte:Einbeziehen einer größeren Anzahl von Dimensionen und Messwerten
- Komplexität des Filters:Verwenden komplexer Filterausdrücke
- Länge des Zeitraums:Abfragen über längere Zeiträume
- Kardinalität der Daten:Dimensionen mit hoher Kardinalität (viele eindeutige Werte, z. B.
pagePath, benutzerdefinierte Dimensionen) können die Tokenkosten erheblich erhöhen. - Ereignisvolumen der Property:Bei Abfragen für Properties mit einem höheren Ereignisvolumen werden möglicherweise mehr Tokens verbraucht als bei derselben Abfrage für eine Property mit weniger Daten.
Tokennutzung überwachen
Die effektivste Methode, um die Tokenkosten für Ihre spezifischen API-Aufrufe
zu ermitteln, besteht darin, den Parameter "returnPropertyQuota": true in den Anfragetext aufzunehmen.
Die API-Antwort enthält dann das Objekt PropertyQuota, in dem die für diese spezifische Anfrage verbrauchten Tokens und die verbleibenden Kontingentsalden aufgeführt sind.