Nutzungslimits und Kontingente

Limits und Kontingente schützen die Google-Infrastruktur vor einem automatisierten Prozess, bei dem die Alert Center API auf unangemessene Weise verwendet wird. Übermäßig viele Anfragen von einer API können die Folge eines harmlosen Tippfehlers oder ein ineffizient gestaltetes System sein, das unnötige API-Aufrufe durchführt. Unabhängig von der Ursache ist es für den Gesamtzustand des Google Workspace-Systems erforderlich, den Traffic von einer bestimmten Quelle zu blockieren, sobald dieser ein bestimmtes Niveau erreicht. Es wird sichergestellt, dass die Aktionen eines Entwicklers keine negativen Auswirkungen auf die gesamte Community haben.

Für den unwahrscheinlichen Fall, dass Ihre API-Anfrage fehlschlägt, erhalten Sie eine Antwort mit dem HTTP-Statuscode. Der Statuscode 403 enthält Fehlerinformationen zu falschen Eingaben und der HTTP-Statuscode 503 enthält Fehlerinformationen, die angeben, welche API-Kontingente überschritten wurden. Anhand dieser Antworten kann Ihre benutzerdefinierte Anwendung diese Fehler erkennen und entsprechende Maßnahmen ergreifen.

Wenn Ihre Anfragen in einem bestimmten Zeitraum ausgeführt werden müssen, senden Sie sie parallel oder verwenden Sie mehrere Threads in Ihrer Java- oder C#-Anwendung. Ein Beispiel für parallele Anfragen besteht darin, kleine Batches von E-Mails von verschiedenen Nutzern anzufordern, anstatt viele E-Mails von einem Nutzer gleichzeitig hinzuzufügen oder zu entfernen. Beginnen Sie bei Threads mit 10 Threads, also jeweils einem Thread pro Nutzer-E‐Mail. Hinweis: Die Thread-Empfehlung hat Nachteile und ist nicht für alle API-Situationen nützlich. Wenn die Anzahl der Anfragen zu hoch wird, treten Kontingentfehler auf.

Bei allen zeitbasierten Fehlern (maximal N Dinge für N Sekunden pro Thread), insbesondere die Fehler mit dem Statuscode 503, empfehlen wir, dass Ihr Code die Ausnahme abfängt und mithilfe eines exponentiellen Backoff-Algorithmus eine kleine Verzögerung wartet, bevor Sie den fehlgeschlagenen Aufruf wiederholen. Ein Alert Center API-Beispiel für einen Thread besteht darin, 5 Sekunden zu warten und den fehlgeschlagenen Aufruf zu wiederholen. Wenn die Anfrage erfolgreich ist, wiederholen Sie dieses Muster für die anderen Threads. Wenn die zweite Anfrage nicht erfolgreich ist, sollte Ihre Anwendung bei der Häufigkeit der Anfrage so lange herunterskalieren, bis ein Aufruf erfolgreich ist. Erhöhen Sie beispielsweise die anfängliche Verzögerung von 5 Sekunden auf 10 Sekunden und wiederholen Sie den fehlgeschlagenen Aufruf. Legen Sie außerdem ein Limit für die Wiederholung fest. Beispiel: Wiederholen Sie eine Anfrage fünf- bis siebenmal mit unterschiedlichen Verzögerungszeiten, bevor die Anwendung einen Fehler an den Nutzer zurückgibt.

API-Grenzwertkategorien Limits
Abfragen pro Sekunde und Abfragen pro Sekunde (QPD) in der Benachrichtigungszentrale Die API begrenzt die Anzahl der Anfragen für Ihr APIs Console-Projekt. Die maximale Anzahl der Anfragen pro Sekunde des API-Projekts (Projekt-Abfragen pro Sekunde) beträgt 1.000. Außerdem beträgt die maximale Anzahl der Anfragen pro Nutzer und Sekunde 150.

Werden diese Limits überschritten, gibt der Server den HTTP-Statuscode 503 zurück. Verwenden Sie den exponentiellen Backoff-Algorithmus, wenn Sie Ihre Anfragen wiederholen.

Andere Arten von Beschränkungen Beschränkungen und Richtlinien
Datenformat, Standard Das Standarddatenformat ist JSON.
Nicht autorisierte Anfragen Google gestattet keine nicht autorisierten Anfragen an diese API. Eine Anfrage gilt als nicht autorisiert, wenn kein Autorisierungstoken angegeben wird. Weitere Informationen finden Sie unter Anfragen autorisieren.

Kontingenterhöhung pro Projekt anfordern

Abhängig von der Ressourcennutzung Ihres Projekts können Sie eine Kontingenterhöhung anfordern. Es wird davon ausgegangen, dass API-Aufrufe durch ein Dienstkonto ein einzelnes Konto nutzen. Wenn Sie ein höheres Kontingent beantragen, bedeutet dies nicht, dass Ihr Antrag auch genehmigt wird. Bei großen Kontingenterhöhungen kann die Genehmigung länger dauern.

Es gelten nicht für alle Projekte dieselben Kontingente. Da Sie Google Cloud im Laufe der Zeit immer mehr nutzen, müssen Ihre Kontingente möglicherweise erhöht werden. Wenn Sie eine deutlich stärkere Auslastung erwarten, können Sie auf der Seite „Kontingente“ in der Google Cloud Console eine Anpassung Ihres Kontingents anfordern.

Weitere Informationen finden Sie in den folgenden Ressourcen: