Limits und Kontingente

Limits und Kontingente schützen die Google-Infrastruktur vor einem automatisierten Prozess, bei dem die Enterprise License Manager API auf unangemessene Weise verwendet wird. Übermäßig viele Anfragen von einer API können auf einen harmlosen Tippfehler zurückzuführen sein oder auf ein ineffizient gestaltetes System zurückzuführen 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 falscher Eingabe 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 innerhalb eines bestimmten Zeitraums verarbeitet werden müssen, können Sie sie in einem Batch senden. Je nach API-Zweck und wenn die Anzahl der Anfragen zu hoch wird, treten Kontingentfehler auf.

Wenn Sie die empfohlene Funktion für API-Batchanfragen nicht verwenden können, nutzen Sie den exponentiellen Backoff-Algorithmus. Bei allen zeitbasierten Fehlern (maximal N Dinge für X Sekunden pro Thread), insbesondere bei Fehlern im 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 Beispiel einer Enterprise License Manager 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 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-Kontingentkategorien	Kontingente
Abfragen pro Sekunde (Queries per second, QPS)	Das Kontingent für Abfragen pro Sekunde beträgt 1.

API-Grenzwertkategorien	Limits
Abfragestring „maxResults“	Die maximale Größe von „maxResults“ ist 100.

Andere Arten von Beschränkungen	Beschränkungen und Richtlinien
Batchanfragen	Die API unterstützt das Senden von Batchanfragen.
Datenformat in API-Antworten	Das Datenformat der Antwort ist JavaScript Object Notation (JSON).
Enterprise License Manager API aktivieren	Die Provisioning API muss aktiviert werden, bevor die Enterprise License Manager API aufgerufen werden kann. Wechseln Sie in Ihrem Steuerfeld zur Registerkarte Nutzer und Gruppen auf der Seite Einstellungen und aktivieren Sie das Nutzerverwaltungs-API. Speichern Sie die Änderungen. Außerdem muss der Google Groups-Dienst aktiviert und aktiviert sein.
Nicht autorisierte Anfragen	Die API akzeptiert keine nicht autorisierten Anfragen. Eine Anfrage gilt als nicht autorisiert, wenn kein Autorisierungstoken angegeben wird. Weitere Informationen finden Sie unter Anfragen autorisieren .