Limits und Kontingente für API-Anfragen

In diesem Dokument werden die Limits und Kontingente für die Anfrage von Management APIs und Reporting APIs beschrieben.

Google Analytics wird von Millionen von Websites verwendet. Wir begrenzen Limits und Kontingente für API-Anfragen, um das System davor zu schützen, mehr Daten zu empfangen, als es verarbeiten kann, und um eine gerechte 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 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 erhöht werden können
  • 10 Abfragen pro Sekunde pro IP-Adresse
    • In der API Console gibt es ein ähnliches Kontingent, das als Anfragen pro 100 Sekunden und Nutzer bezeichnet wird. Standardmäßig ist es auf 100 Anfragen pro 100 Sekunden und Nutzer festgelegt. Der Wert kann auf einen Höchstwert von 1.000 festgelegt werden. Die Anzahl der Anfragen an die API ist jedoch auf maximal zehn Anfragen pro Sekunde und Nutzer beschränkt.
    • Wenn Ihre Anwendung alle API-Anfragen von einer einzigen IP-Adresse aus sendet (d.h. im Namen Ihrer Nutzer), verwenden Sie bei jeder Anfrage den Parameter userIP oder quotaUser, um für jeden Nutzer das vollständige Kontingent für Abfragen pro Sekunde zu erhalten. Weitere Informationen finden Sie in der Übersicht der Standard-Abfrageparameter.

Reporting APIs

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

  • 10.000 Anfragen pro Aufruf (Profil) pro Tag (kann nicht erhöht werden)
  • 10 Anfragen gleichzeitig pro Aufruf (Profil) (kann nicht erhöht werden)

Fehler bei der Reporting API

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 nicht mehr als einmal, wenn sie wiederholt fehlschlägt. In Google Analytics ist Folgendes möglich:

  • 10 Serverfehler fehlgeschlagene Anfragen pro Projekt, Ansicht (Profil) und Stunde
  • 50 Serverfehler bei Anfragen pro Projekt, Datenansicht (Profil) und Tag

Wenn die Anzahl der fehlgeschlagenen Anfragen diese Kontingente überschreitet, wird der folgende Fehler ausgegeben:

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.

Um die Wahrscheinlichkeit zu verringern, dass ein Anfrageserverfehler auftritt, vereinfachen Sie die Anfrage: Reduzieren Sie dazu den Zeitraum, verringern Sie die Anzahl der Dimensionen in der Anfrage oder verringern Sie die Anzahl der Messwerte in der Anfrage.

Senden Sie eine fehlgeschlagene Anfrage nicht wiederholt. Implementieren Sie stattdessen den exponentiellen Backoff, um ihn noch einmal einzureichen.

Kontingente für Serverfehlerraten werden über rollierende Zeiträume für jedes stündliche und tägliche Fehlerkontingent erzwungen. Eine Stunde nach dem ersten Serverfehler des Paars aus Projekt und Ansicht wird das Kontingent zurückgesetzt. Wenn ein Projekt- und Ansichtspaar 10 Serverfehler in einer Stunde sendet, werden das Projekt- und Ansichtspaar für die API bis zu einer Stunde nach Ablauf des ersten Serverfehlers blockiert.

Wenn beispielsweise bei einem Projekt- und Ansichtspaar in den letzten 24 Stunden kein Serverfehler gesendet wurde, wurde für dieses Projekt und diese Ansicht 0 der 50 Kontingente verwendet. Angenommen, dieses Projekt und diese Ansicht senden jetzt einen Serverfehler um 6:12 Uhr. Wenn für dieses Projekt und diese Ansicht vor 6:12 Uhr des folgenden Tages 49 zusätzliche Serverfehler gesendet werden, werden das Projekt und die Ansicht bis 6:12 Uhr des Folgetags blockiert. Am nächsten Tag um 6:12 Uhr wird die Fehlerrate für dieses Projekt und diese Datenansicht vollständig zurückgesetzt.

Analytics Reporting API Version 4

Diese Kontingente gelten nur für die Analytics Reporting API Version 4:

  • Anzahl der Anfragen pro Tag und Projekt: 50.000
  • Anzahl der Anfragen pro Aufruf (Profil) pro Tag: 10.000 (kann nicht erhöht werden)
  • Anzahl der Anfragen pro 100 Sekunden und Projekt: 2.000
  • Anzahl der Anfragen pro 100 Sekunden und Nutzer pro Projekt: 100. Dieser Wert kann in der Google API Console auf 1.000 erhöht werden.

Die Kontingente Ihres Projekts finden Sie in der Google API Console.

Ressourcenbasiertes Kontingent

Die Analytics Reporting API v4 unterliegt ebenfalls dem optionalen ressourcenbasierten Kontingent, das für Analytics 360-Kunden die Verwendung höherer Schwellenwerte für die Stichprobenerhebung ermöglicht.

Kontingentlimits überschritten

Wenn das Kontingent zum Anfordern einer Google Analytics API überschritten wird, gibt die API den Fehlercode 403 oder 429 und 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 anfordern:

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. Öffnen Sie die Seite „Aktivierte APIs“ der API-Bibliothek in der API-Konsole 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 Kontingentbetrags beantragen möchten, verwenden Sie bitte das Anfrageformular für den Analytics API-Kontingent. Lesen Sie die Informationen und folgen Sie der Anleitung im Formular zur Kontingentanfrage, 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 v3-APIs (z.B. Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3, sind in der Google API Console unter Analytics API aufgeführt.

Weitere Informationen zur Kontingentverwaltung und zur Optimierung Ihrer Anwendung für die Kontingentnutzung finden Sie unter APIs überwachen und Nutzung begrenzen.