Nutzungslimits und Kontingente

Durch Limits und Kontingente wird die Google-Infrastruktur vor automatisierten Prozessen geschützt, die die Alert Center API auf unangemessene Weise verwenden. Eine übermäßige Anzahl von Anfragen von einer API kann durch einen harmlosen Tippfehler oder ein ineffizient gestaltetes System verursacht werden, das unnötige API-Aufrufe ausführt. Unabhängig von der Ursache ist es für den Gesamtzustand des Google Workspace-Systems wichtig, den Traffic von einer bestimmten Quelle zu blockieren, sobald er einen bestimmten Wert erreicht. So wird sichergestellt, dass die Aktionen eines Entwicklers keine negativen Auswirkungen auf die gesamte Community haben.

Im unwahrscheinlichen Fall, dass Ihre API-Anfrage fehlschlägt, erhalten Sie eine Antwort mit einem HTTP-Statuscode. Ein Statuscode von 403 enthält Fehlerinformationen zu falscher Eingabe und ein HTTP-Statuscode von 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 innerhalb eines bestimmten Zeitraums abgeschlossen werden müssen, senden Sie sie parallel oder verwenden Sie mehrere Threads in Ihrer Java- oder C#-Anwendung. Ein Beispiel für parallele Anfragen ist das Anfordern kleiner Batches von E-Mails von verschiedenen Nutzern, anstatt viele E-Mails von einem Nutzer gleichzeitig hinzuzufügen oder zu entfernen. Bei Threads sollten Sie mit 10 Threads beginnen, einem Thread pro E-Mail-Adresse des Nutzers. Die Empfehlung für Threads hat Nachteile und ist nicht für alle API-Situationen nützlich. Wenn die Anzahl der Anfragen zu hoch ist, treten Kontingentfehler auf.

Bei allen zeitbasierten Fehlern (maximal N Vorgänge für N Sekunden pro Thread), insbesondere bei Fehlern mit dem Statuscode 503, empfehlen wir, dass Ihr Code die Ausnahme abfängt und mit einem exponentiellen Backoff-Algorithmus eine kurze Zeit wartet, bevor er den fehlgeschlagenen Aufruf wiederholt. Ein Beispiel für die Alert Center API für einen Thread ist, 5 Sekunden zu warten und den fehlgeschlagenen Aufruf noch einmal zu versuchen. Wenn die Anfrage erfolgreich ist, wiederholen Sie diesen Vorgang für die anderen Threads. Wenn die zweite Anfrage nicht erfolgreich ist, sollte die Häufigkeit der Anfragen in Ihrer Anwendung reduziert werden, bis ein Aufruf erfolgreich ist. Erhöhen Sie beispielsweise die anfängliche Verzögerung von 5 Sekunden auf 10 Sekunden und versuchen Sie es noch einmal. Legen Sie außerdem ein Limit für Wiederholungsversuche fest. Wiederholen Sie eine Anfrage beispielsweise 5- bis 7-mal mit unterschiedlichen Verzögerungszeiten, bevor Ihre Anwendung einen Fehler an den Nutzer zurückgibt.

API-Limitkategorien Limits
QPS- und QPD-Raten für die Benachrichtigungszentrale Die API begrenzt die Anzahl der Anfragen für Ihr API Console-Projekt. Die maximale Anzahl von Anfragen pro Sekunde (Projekt-QPS) für das API-Projekt beträgt 1.000. Die maximale Anzahl von Anfragen pro Nutzer und Sekunde (Nutzer-QPS) beträgt 150.

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

Andere Arten von Limits Einschränkungen und Richtlinien
Standarddatenformat Das Standarddatenformat ist JSON.
Nicht autorisierte Anfragen Google lässt keine unautorisierten Anfragen an diese API zu. 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 Kontingentanpassung beantragen. API-Aufrufe durch ein Dienstkonto werden als Aufrufe über ein einzelnes Konto betrachtet. Wenn Sie ein angepasstes Kontingent beantragen, bedeutet dies nicht, dass Ihr Antrag auch genehmigt wird. Die Genehmigung von Anfragen zur Kontingentanpassung, die den Kontingentwert erheblich erhöhen würden, kann länger dauern.

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

Weitere Informationen finden Sie in den folgenden Ressourcen: