Für die Data API gelten die folgenden Limits und Kontingente.
So werden Kontingente angewendet
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 werden.
API-Schlüssel werden verwendet, um eine Anfrage zu Kontingent- und Abrechnungszwecken einem bestimmten Google Cloud-Projekt zuzuordnen. 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
Für die Data API gibt es drei Kontingentkategorien für Anfragen: „Core“, „Realtime“ und „Funnel“. Für API-Anfragen an Core-Methoden werden Core-Kontingente berechnet. Für API-Anfragen an Echtzeitmethoden wird das Echtzeitkontingent belastet. 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 | Limit für Standard-Properties | Limit für Analytics 360-Properties |
|---|---|---|
| Core-Tokens pro Property und Tag | 200.000 | 2.000.000 |
| Core-Tokens pro Property und Stunde | 40.000 | 400.000 |
| Kern-Tokens pro Projekt, Property und Stunde | 14.000 | 140.000 |
| Gleichzeitige Kernanfragen pro Property | 10 | 50 |
| Häufige 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 Echtzeitanfragen 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 Anfragen pro Property im Trichter | 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. Um die Anzahl gleichzeitiger Anfragen zu reduzieren, 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 aufgebraucht sind, werden alle Anfragen an die Property aus dem Projekt blockiert.
- Für jede Anfrage wird das Kontingent für „Tokens pro Property pro Stunde“ und „Tokens pro Projekt pro Property pro Stunde“ verbraucht. Das bedeutet, dass auf eine Property von mehr als drei Projekten zugegriffen werden muss, bevor das Kontingent „Tokens pro Property pro Stunde“ vor dem Kontingent „Tokens pro Projekt pro Property pro Stunde“ erschöpft sein kann.
Für Properties sind 120 Anfragen pro Stunde zulässig, bei denen möglicherweise der Schwellenwert überschritten wird. Die Dimensionen userAgeBracket, userGender, brandingInterest, audienceId und audienceName werden möglicherweise zusammengefasst. 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. Die meisten Anfragen kosten 10 Tokens oder weniger, komplexere Anfragen kosten mehr.
Faktoren, die den Tokenverbrauch beeinflussen
Die genauen Token-Kosten für eine Anfrage werden zum Zeitpunkt der Ausführung ermittelt, was eine genaue Vorabberechnung erschwert. Die Kosten hängen von einer Kombination aus Faktoren ab, 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:Sie fordern eine größere Anzahl von Zeilen an.
- Anzahl der Dimensionen und Messwerte:Sie können mehr Dimensionen und Messwerte einbeziehen.
- Filterkomplexität:Verwendung komplexer Filterausdrücke.
- Länge des Zeitraums:Abfragen über längere Zeiträume hinweg.
- Datenkardinalität:Dimensionen mit hoher Kardinalität (viele eindeutige Werte, z. B.
pagePath, benutzerdefinierte Dimensionen) können die Tokenkosten erheblich steigern. - Ereignisvolumen der Property:Abfragen für Properties mit einem höheren Ereignisvolumen verbrauchen möglicherweise mehr Tokens als dieselbe Abfrage für eine Property mit weniger Daten.
Tokennutzung überwachen
Die effektivste Methode, 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 PropertyQuota-Objekt, in dem die von dieser bestimmten Anfrage verbrauchten Tokens und die verbleibenden Kontingentsalden aufgeführt sind.