API-Nutzungslimits

Limits und Kontingente schützen die Google-Infrastruktur vor einem automatisierten Prozess, der die Groups Settings API auf unzulässige Weise verwendet. Übermäßig viele Anfragen von einer API können durch einen harmlosen Tippfehler oder ein ineffizient gestaltetes System verursacht werden, das unnötige API-Aufrufe durchführt. Unabhängig von der Ursache ist es für den Gesamtzustand des Google Workspace-Systems erforderlich, Traffic von einer bestimmten Quelle zu blockieren, sobald dieser ein bestimmtes Niveau erreicht.

Fehler bei API-Anfragen

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

Zeitkritische Anfragen

Wenn Ihre Anfragen in einem bestimmten Zeitraum abgeschlossen werden müssen, senden Sie sie parallel oder verwenden Sie mehrere Threads in Ihrer Java- oder C#-Anwendung. Unterteilen Sie Ihre Anfragen beispielsweise nach Monaten oder einem anderen Zeitraum. Beginnen Sie bei Threads mit 10 Threads, einem Thread pro Anfrage. 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.

Zeitbasierte Fehler

Bei allen zeitbasierten Fehlern (maximal N Dinge für X Sekunden pro Thread), insbesondere die Fehler im Statuscode 503, sollte der Code die Ausnahme abfangen und mithilfe eines exponentiellen Backoff-Algorithmus eine kleine Verzögerung warten, bevor Sie den fehlgeschlagenen Aufruf wiederholen. Ein Beispiel für die Groups Settings API 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 die Häufigkeit der Anfrage 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 Wiederholungslimit fest. Beispiel: Wiederholen Sie eine Anfrage fünf- bis siebenmal mit unterschiedlichen Verzögerungszeiten, bevor die Anwendung einen Fehler an den Nutzer zurückgibt.

Kontingente

API-Kontingentkategorien Kontingente
Abfragen pro Tag

Sie können bis zu 100.000 Abfragen pro Tag stellen. Wenn Sie Kapazitäten über dieses Limit hinaus benötigen, können Sie über die Seite Kontingente in der Google Cloud Console eine Anfrage senden.
Gruppenbeschreibung, maximale Größe Sie können eine Gruppenbeschreibung mit bis zu 300 Zeichen eingeben.
Gruppenname, maximale Größe Der Name einer Gruppe kann bis zu 60 Zeichen lang sein.
defaultMessageDenyNotificationText Der Benachrichtigungstext kann bis zu 10.000 Zeichen umfassen. Weitere Informationen zum Attribut defaultMessageDenyNotificationText finden Sie in der API-Referenz.
maxMessageBytes Die maximale Standardgröße für Nachrichten beträgt 1 MB. Weitere Informationen zum Attribut maxMessageBytes finden Sie in der API-Referenz.

Einschränkungen

Arten von Beschränkungen Einschränkungen und Richtlinien
Datenformat, Standard
 Das Standarddatenformat ist JSON. Die API unterstützt auch das Atom-Format. Sowohl das JSON- als auch das Atom-Datenformat unterstützen vollständige Lese-/Schreibfunktionen. Weitere Informationen finden Sie unter JSON- und Atom-Datenformate.
Groups Settings API, Aktivierung Sie müssen die Directory API aktivieren, bevor Sie die Groups Settings API aufrufen. Weitere Informationen finden Sie unter Google Workspace APIs aktivieren.