Limits und Kontingente für API-Anfragen

In diesem Dokument werden die Limits und Kontingente für das Anfordern 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 eine gleichmäßige Verteilung der Systemressourcen zu gewährleisten. 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 v3, die MCF Reporting API, die Metadata API, die User Deletion API und die Real Time Reporting API:

  • 50.000 Anfragen pro Projekt und Tag, kann erhöht werden.
  • 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 sendet (also im Namen Ihrer Nutzer), verwenden Sie für jede Anfrage den Parameter userIP oder quotaUser, um das volle Kontingent für Abfragen pro Sekunde pro Nutzer zu erhalten. Weitere Informationen finden Sie in der Zusammenfassung der Standardabfrageparameter.

Reporting APIs

Die folgenden Kontingente gelten für alle Reporting APIs, einschließlich der Core Reporting API Version 3, der Analytics Reporting API Version 4, der Real Time API Version 3 und der Multi-Channel Funnel API (Version 3):

  • 10.000 Anfragen pro Datenansicht (Profil) und Tag (kann nicht erhöht werden)
  • 10 gleichzeitige Anfragen pro Ansicht (Profil) (kann nicht erhöht werden)
Analytics Real Time Reporting API-Aufrufe werden getrennt von anderen Analytics APIs erfasst. Sie können also 10.000 Aufrufe pro Tag und Datenansicht (Profil) mit der Analytics Real Time Reporting API UND weitere 10.000 Aufrufe pro Tag und Datenansicht (Profil) mit anderen Analytics APIs ausführen.

Dieses Verhalten ermöglicht eine detailliertere und sicherere Verwaltung von Kontingenten, sodass häufige Aufrufe der Analytics Real Time Reporting API nicht versehentlich alle anderen Analytics API-Aufrufe für den Rest des Tages für eine einzelne Datenansicht (Profil) blockieren.

Fehler bei API-Anfragen melden

Wenn Ihre Anfrage an die Reporting API aufgrund eines Serverfehlers fehlschlägt, erhalten Sie den Antwortcode 500 oder 503. Sie können die Anfrage noch einmal senden. Senden Sie sie jedoch nur einmal, wenn sie wiederholt fehlschlägt. Google Analytics ermöglicht Folgendes:

  • 10 fehlerhafte Anfragen aufgrund von Serverfehlern pro Projekt pro Datenansicht (Profil) und Stunde
  • 50 fehlgeschlagene Serverfehler pro Projekt, Datenansicht (Profil) und Tag

Wenn die Anzahl Ihrer fehlgeschlagenen Anfragen diese Kontingente überschreitet, erhalten Sie die folgende Fehlermeldung:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

Vereinfachen Sie die Anfrage, um die Wahrscheinlichkeit von Fehlern beim Anfragenserver zu verringern. Verkürzen Sie daher den Zeitraum, verringern Sie die Anzahl der Dimensionen in der Anfrage oder die Anzahl der Messwerte in der Anfrage.

Reichen Sie eine fehlgeschlagene Anfrage nicht ständig noch einmal ein. Stattdessen können Sie den exponentiellen Backoff implementieren, um ihn noch einmal zu senden.

Kontingente für Serverfehlerraten werden über rollierende Zeitfenster für jedes der stündlichen und täglichen Fehlerratenkontingente erzwungen. Eine Stunde nach dem ersten Serverfehler eines Projekt- und Ansichtspaars wird das Kontingent zurückgesetzt. Wenn ein Projekt-Ansicht-Paar innerhalb einer Stunde 10 Serverfehler sendet, wird das Projekt-/Datenansichtspaar bis zur Stunde nach Ablauf des ersten Serverfehlers von der API blockiert.

Wenn beispielsweise ein Projekt und eine Ansicht in den letzten 24 Stunden keinen Serverfehler gesendet haben, werden für dieses Projekt und diese Ansicht 0 des Kontingents von 50 genutzt. Angenommen, das Projekt und die Ansicht senden um 6:12 Uhr einen Serverfehler. Wenn für dieses Projekt und diese Ansicht vor 6:12 Uhr des folgenden Tages 49 weitere Serverfehler gesendet werden, werden das Projekt und die Ansicht bis 6:12 Uhr des Folgetags blockiert. Um 6:12 Uhr des folgenden Tages wird das Kontingent für die Serverfehlerrate für dieses Projekt und diese Ansicht vollständig zurückgesetzt.

Kontingentlimits überschreiten

Wenn das Kontingent zum Anfordern 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 folgende Erhöhung beantragen:

Wenn Sie die Nutzungslimits für Ihr Projekt aufrufen oder ändern bzw. eine Erhöhung Ihres Kontingents anfragen möchten, gehen Sie so vor:

  1. Wenn Sie für Ihr Projekt noch kein Rechnungskonto haben, erstellen Sie dieses.
  2. Rufen Sie in der API Console die Seite „Aktivierte APIs“ der API-Bibliothek auf und wählen Sie eine API aus der Liste aus.
  3. 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. Für die 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 und User Deletion API Version 3) werden in der Google API Console unter Analytics API aufgeführt.

Weitere Informationen zur Kontingentverwaltung und zur Optimierung der Kontingentnutzung für Ihre Anwendung finden Sie unter Monitoring APIs und Nutzungsbegrenzung.