Durch Limits und Kontingente wird die Google-Infrastruktur vor automatisierten Prozessen geschützt, die die Alert Center API auf unangemessene Weise verwenden. Übermäßige Anfragen von einer API können 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 verhindert, dass die Aktionen eines Entwicklers sich negativ auf die größere Community auswirken.
Im unwahrscheinlichen Fall, dass Ihre API-Anfrage fehlschlägt, erhalten Sie eine HTTP-Statuscode-Antwort. Ein Statuscode von 403 enthält Fehlerinformationen zu einer falschen Eingabe und ein HTTP-Statuscode von 503 enthält Fehlerinformationen, die angeben, welche API-Kontingente überschritten wurden. Mit diesen Antworten kann Ihre benutzerdefinierte Anwendung diese Fehler erkennen und entsprechende Maßnahmen ergreifen.
Wenn Ihre Anfragen innerhalb eines bestimmten Zeitraums abgeschlossen sein 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 E-Mail-Batches von verschiedenen Nutzern, anstatt viele E-Mails gleichzeitig von einem Nutzer 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 jedoch Vor- und Nachteile und ist nicht für alle API-Situationen geeignet. Wenn die Anzahl der Anfragen zu hoch ist, treten Kontingentfehler auf.
Bei allen zeitbasierten Fehlern (maximal N Elemente 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 Verzögerung abwartet, bevor der fehlgeschlagene Aufruf wiederholt wird. Ein Beispiel für die Alert Center API für einen Thread ist, 5 Sekunden zu warten und den fehlgeschlagenen Aufruf zu wiederholen. Wenn die Anfrage erfolgreich ist, wiederholen Sie diesen Vorgang für die anderen Threads. Wenn die zweite Anfrage nicht erfolgreich ist, sollte Ihre Anwendung die Häufigkeit der Anfrage reduzieren, 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 noch einmal. Legen Sie außerdem ein Limit für die Wiederholungen 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 |
|---|---|
| Abfragen pro Sekunde (QPS) und Abfragen pro Tag (QPD) für die Benachrichtigungszentrale | Die API begrenzt die Anzahl der Anfragen für Ihr Google Cloud-Projekt.
Die maximale Anzahl von Anfragen pro Sekunde für das API-Projekt (QPS des Projekts)
beträgt 1.000. Die maximale Anzahl von Anfragen pro Nutzer und Sekunde
(QPS des Nutzers) beträgt 150.
Wenn diese Limits überschritten werden, gibt der Server den HTTP
|
| Andere Arten von Limits | Einschränkungen und Richtlinien |
|---|---|
| Datenformat, Standard | Das Standarddatenformat ist JSON. |
| Nicht autorisierte Anfragen | Google lässt keine nicht autorisierten Anfragen an diese API zu. Eine Anfrage gilt als nicht autorisiert, wenn kein Autorisierungstoken angegeben ist. Weitere Informationen finden Sie unter Anfragen autorisieren. |
Kontingenterhöhung pro Projekt anfordern
Abhängig von der Ressourcennutzung Ihres Projekts können Sie eine Kontingentanpassung anfordern. API-Aufrufe durch ein Dienstkonto werden als Nutzung eines einzelnen Kontos betrachtet. Wenn Sie ein angepasstes Kontingent beantragen, bedeutet dies nicht, dass Ihr Antrag auch genehmigt wird. Anfragen zur Kontingentanpassung, die den Kontingentwert erheblich erhöhen würden, können länger dauern, bis sie genehmigt werden.
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 proaktiv eine Anpassung Ihres Kontingents anfordern auf der Seite Kontingente und Systemlimits der Google Cloud Console.
Weitere Informationen finden Sie in folgenden Dokumenten: