Limits und Kontingente schützen die Google-Infrastruktur vor einem automatisierten Prozess, der den Groups Settings API auf unangemessene Weise verwenden. Übermäßig viele Anfragen von einer API können aus einem ein harmloser Tippfehler oder ein ineffizient gestaltetes System, das unnötige API-Aufrufe durchführt. Unabhängig von der Ursache sollten Sie den Traffic von einer bestimmten Quelle blockieren, sobald dieser ein bestimmtes Niveau erreicht. die für den Gesamtzustand des Google Workspace-Systems erforderlich sind.
Fehler bei API-Anfragen
Im unwahrscheinlichen Fall, dass Ihre API-Anfrage fehlschlägt, erhält Ihre Anwendung einen HTTP-Statuscode
Antwort. Der HTTP-Statuscode 403 enthält Fehlerinformationen, die angeben, welche API-Kontingente es gibt
wurden überschritten. Mithilfe der Antwort kann Ihre benutzerdefinierte Anwendung Fehler erkennen und entsprechende
Aktion ausführen.
Zeitkritische Anfragen
Wenn Ihre Anfragen innerhalb eines bestimmten Zeitraums bearbeitet werden müssen, senden Sie sie parallel. oder mehrere Threads in Ihrer Java- oder C#-Anwendung verwenden. Unterteilen Sie Ihre Anfragen beispielsweise nach Monaten oder aus einem anderen Zeitraum. Beginnen Sie bei Threads mit 10 Threads (ein 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 der
503-Statuscodefehler enthält, empfehlen wir, dass Ihr Code die Ausnahme abfangen und
eine
exponentieller Backoff
warten Sie eine kleine Verzögerung, bevor Sie den fehlgeschlagenen Aufruf wiederholen. Ein Beispiel für die Groups Settings API für
in einem Thread ist es, 5 Sekunden zu warten und den fehlgeschlagenen Aufruf zu wiederholen. Wenn die Anfrage erfolgreich war, wiederholen Sie dies.
für die anderen Threads. Wenn die zweite Anfrage nicht erfolgreich ist, sollte sich Ihr Antrag
die Häufigkeit der Anfrage verringern, bis ein Aufruf erfolgreich ist. Erhöhen Sie beispielsweise den Wert
Verzögerung von 5 Sekunden auf 10 Sekunden und wiederholen Sie den fehlgeschlagenen Anruf. Wiederholungsversuch festlegen
Limit Wiederholen Sie beispielsweise eine Anfrage fünf- bis siebenmal mit unterschiedlichen Verzögerungszeiten, bevor Ihre Bewerbung
gibt einen Fehler an den Nutzer zurück.
Kontingente
| API-Kontingentkategorien | Kontingente |
|---|---|
| Abfragen pro Tag | Sie können bis zu 100.000 Abfragen pro Tag durchführen. Wenn Sie Kapazitäten benötigen, die über können Sie über die Seite Kontingente in der Google Cloud Console |
| Gruppenbeschreibung, maximale Größe | Sie können eine Gruppenbeschreibung mit bis zu 4.096 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 zur
defaultMessageDenyNotificationText, siehe
API-Referenz.
|
maxMessageBytes |
Die standardmäßige maximale Nachrichtengröße beträgt 1 MB. Weitere Informationen zum maxMessageBytes
finden Sie in der API-Referenz.
|
Limits
| Arten von Limits | Einschränkungen und Richtlinien |
|---|---|
| Datenformat, Standard |
Das Standarddatenformat ist JSON. Die API unterstützt auch das Atom-Format. Sowohl die JSON- als auch die Atom- unterstützen die vollständigen 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 Weitere Informationen finden Sie unter Google Workspace APIs aktivieren. |