In diesem Dokument werden die Limits und Kontingente für die Anforderung der Management APIs und Reporting APIs beschrieben.
Google Analytics wird von Millionen von Websites verwendet. Wir legen Limits und Kontingente für API-Anfragen fest, um zu verhindern, dass das System mehr Daten erhält, als es verarbeiten kann, und um für eine ausgewogene Verteilung der Systemressourcen zu sorgen. Die Limits und Kontingente können sich ändern.
In diesem Video werden die Best Practices für die Verwaltung von Google Analytics API-Anfragekontingenten erläutert.
Allgemeine Kontingentlimits
Die folgenden Kontingente gelten für die Management API, die Core Reporting API (Version 3), die MCF Reporting API, die Metadata API, die User Deletion API und die Real Time Reporting API:
- 50.000 Anfragen pro Projekt und Tag, die erweitert werden können
- 10 Abfragen pro Sekunde pro IP-Adresse
- In der API-Konsole gibt es ein ähnliches Kontingent, das als Anfragen pro 100 Sekunden und Nutzer bezeichnet wird. Standardmäßig ist er auf 100 Anfragen pro 100 Sekunden und Nutzer eingestellt und kann auf einen Höchstwert von 1.000 angepasst werden. Die Anzahl der Anfragen an die API ist jedoch auf maximal 10 Anfragen pro Sekunde und Nutzer beschränkt.
- Wenn Ihre Anwendung alle API-Anfragen von einer einzigen IP-Adresse aus (im Namen Ihrer Nutzer) sendet, verwenden Sie den Parameter
userIP
oderquotaUser
für jede Anfrage, um das volle Kontingent für die Abfragen pro Sekunde für jeden Nutzer zu erhalten. Weitere Informationen finden Sie in der Zusammenfassung der Standardabfrageparameter.
Verwaltungs-APIs
In Google Analytics werden Kontingente für Anfragen an diese Management APIs angewendet:
APIs schreiben
Diese Kontingente gelten für Schreibanfragen (insert
, update
, patch
und delete
):
- 50 Schreibanfragen pro Projekt und Tag, die kann erhöht werden
- 1,5 Abfragen pro Sekunde pro Konto-ID
Fehler bei Schreibanfrage
Wenn Ihre Schreibanfrage fehlschlägt und Sie den Antwortcode 500
oder 503
erhalten, können Sie sie noch einmal senden. Google Analytics ermöglicht Folgendes:
- 50 fehlgeschlagene Schreibanfragen pro Stunde.
Wenn Sie versuchen, mehr als 50 fehlgeschlagene Schreibanfragen pro Stunde zu senden, erhalten Sie die folgende Fehlermeldung:
Quota Error: The number of recent failed writes is too high.
Statt eine fehlgeschlagene Schreibanfrage immer wieder neu zu senden, können Sie den exponentiellen Backoff implementieren, um die Anfrage noch einmal einzureichen.
Datenimport-API
Diese Kontingente gelten speziell für die Ressource Uploads
:
- Lebenslanges Speicherlimit für den erweiterten Datenimport (gilt nicht für Trefferdaten, die von den Collection APIs und SDKs gesendet werden):
- Analytics 360-Limits für den Importmodus „Verarbeitungszeit“:
- 1 TB pro Property
- 20 GB pro Datensatz
- Analytics 360-Limits für den Importmodus „Abfragezeit“:
- 1 GB pro Property
- 1 GB pro Datensatz
- Standard limits:
- 10 GB pro Property
- 10 GB pro Datensatz
- Analytics 360-Limits für den Importmodus „Verarbeitungszeit“:
- 50 Datensätze pro Property
- 50 Uploadvorgänge pro Property und Tag
- 1 GB pro hochgeladener Datei
- Limits für Kostendaten:
- 100 MB pro Datum (
ga:date
) und Datensatz. Wenn Sie beispielsweise in einem Upload 50 MB für den 10.10.2014 und in einem zweiten Upload 50 MB Daten für den 10.10.2014 importieren, haben Sie das Limit von 100 MB für den 10.10.2014 für diesen Datensatz erreicht.
- 100 MB pro Datum (
Tests-API
Dieses Kontingent gilt nur für Tests:
- 12 Tests pro Datenansicht (Profil)
Tests mit einer der folgenden statuses
werden auf dieses Kontingent angerechnet:
DRAFT
READY_TO_RUN
RUNNING
Tests, die länger als einen Tag beendet wurden (Status = ENDED
), werden nicht auf dieses Kontingent angerechnet.
Gesamtdatenberichte API
Diese Kontingente gelten nur für Gesamtdatenberichte:
- API-Anfragen zum Erstellen von Gesamtdatenberichten werden auf das allgemeine Kontingent für Schreibanfragen angerechnet.
- Die API verwendet dasselbe Tokensystem pro Property und Tag, mit dem die Weboberfläche Gesamtdatenberichte erstellt.
- Es sind maximal 3.500 Gesamtdatenberichte zulässig. Wenn diese Grenze erreicht ist, wird beim Erstellen weiterer Gesamtdatenberichte mit der API folgender Fehler ausgegeben:
Error creating this entity. You have reached the maximum allowed entities of this type.
User Permission API
Dieses Kontingent gilt nur für Nutzerberechtigungen:
- Ein Nutzer kann höchstens 100 Analytics-Konten haben. Beim Hinzufügen eines Nutzers mit 100 Analytics-Konten zu einem neuen Konto tritt ein Fehler auf.
Die folgenden Kontingente gelten für Batch-Schreibanfragen (delete
, insert
, update
) an Nutzerberechtigungen:
- 300 Schreibanfragen für Nutzerberechtigungen pro Batchanfrage
- 30 aufeinanderfolgende Schreibanfragen für Nutzerberechtigungen zählen als 1 Schreibanfrage.
Kontingentlimits überschritten
Wenn das Kontingent für die Anforderung einer Google Analytics API überschritten wird, gibt die API den Fehlercode 403
oder 429
sowie eine Meldung zurück, dass das Konto das Kontingent überschritten hat. Weitere Informationen finden Sie in den Nutzungsbedingungen.
Weitere Kontingente anfordern
Sie können nur eine Erhöhung beantragen:
- Die Anzahl der täglichen Leseanfragen pro Projekt (50.000 Standardanfragen)
- Die Anzahl der täglichen Schreibanfragen pro Projekt (50 Standardanfragen)
Wenn Sie die Nutzungslimits für Ihr Projekt aufrufen oder ändern bzw. eine Erhöhung Ihres Kontingents anfragen möchten, gehen Sie so vor:
- Wenn Sie für Ihr Projekt noch kein Rechnungskonto haben, erstellen Sie dieses.
- Rufen Sie in der API Console die Seite „Aktivierte APIs“ auf und wählen Sie eine API aus der Liste aus.
- Klicken Sie auf Kontingente, um die Einstellungen zum Kontingent aufzurufen und zu ändern. Klicken Sie auf Nutzung, um die Nutzungsstatistik einzusehen.
Wenn Sie eine Erhöhung des maximalen Kontingents beantragen möchten, verwenden Sie bitte das Anfrageformular für Analytics API-Kontingente. Lesen Sie die Informationen und folgen Sie der Anleitung im Kontingentanfrageformular, bevor Sie die Anfrage senden. Bei der Reporting API v4 lautet der API-Name in der Google API Console Google Analytics Reporting API. Alle anderen APIs der Version 3 (z.B. Management API Version 3, Core Reporting API (Version 3), Real Time Reporting API (Version 3), User Deletion API (Version 3) sind in der Google API Console unter Analytics API aufgeführt.
Weitere Informationen zur Kontingentverwaltung und zur Feinabstimmung Ihrer Anwendung im Hinblick auf die Kontingentnutzung finden Sie unter Monitoring APIs und Nutzungsbeschränkungen.