Nutzungslimits und Kontingente

Limits und Kontingente schützen die Google-Infrastruktur vor automatisierten Prozessen, die die Reseller API unangemessen nutzen. Eine übermäßige Anzahl von Anfragen kann durch einen Tippfehler oder ein ineffizientes Systemdesign verursacht werden. Um die Stabilität des Google Workspace-Systems zu gewährleisten, blockiert Google den Traffic aus bestimmten Quellen, wenn er bestimmte Grenzwerte erreicht. So wird verhindert, dass die Aktionen eines Entwicklers sich negativ auf die Community auswirken.

Fehler bei API-Anfragen

Wenn eine API-Anfrage fehlschlägt, erhält Ihre Anwendung einen HTTP-Statuscode. Ein Statuscode 403 weist auf eine falsche Eingabe hin und ein Statuscode 503 darauf, dass die API-Kontingente überschritten wurden. Anhand dieser Antworten können Sie Fehler erkennen und Maßnahmen ergreifen.

Zeitbasierte Fehler

Bei zeitbasierten Fehlern, insbesondere bei 503 Statuscodes, sollten Sie einen exponentiellen Backoff Algorithmus verwenden. Warten Sie kurz, bevor Sie den fehlgeschlagenen Aufruf wiederholen. Warten Sie beispielsweise 5 Sekunden und versuchen Sie es noch einmal. Wenn der Vorgang erfolgreich ist, wiederholen Sie das Muster für andere Threads. Wenn die zweite Anfrage fehlschlägt, reduzieren Sie die Häufigkeit der Anfragen, bis ein Aufruf erfolgreich ist. Es wird auch empfohlen, ein Limit für die Wiederholungen festzulegen, z. B. 5 bis 7 Mal.

Limits

Kategorien von API-Limits Limits
Abo purchaseOrderId Für diese Eigenschaft sind bis zu 80 Zeichen im Nur-Text-Format zulässig.
Abo maxResults Der Abfragestring maxResults kann 1 bis 100 Ergebnisse enthalten. Der Standardwert ist 20 Ergebnisse.
Übertragungstoken (customerAuthToken) Das Übertragungstoken eines Kunden ist nach der Generierung 30 Tage lang gültig.
Maximale Anzahl von Nutzern für einen Kunden Je nach Vertrag kann die maximale Anzahl von Nutzern 50.000 oder die im Reseller-Vertrag festgelegte maximale Anzahl betragen.
Nicht autorisierte Anfragen Google lässt keine nicht autorisierten Anfragen an die Reseller API zu. Eine Anfrage ist nicht autorisiert, wenn kein Autorisierung Token angegeben wird. Weitere Informationen finden Sie unter Authentifizierung und Autorisierung.

Andere Arten von Limits

Andere Arten von Limits Einschränkungen und Richtlinien
Datenformat Das Datenformat ist JavaScript Object Notation (JSON).

JSON ist ein gängiges Internetformat zur Darstellung beliebiger Daten strukturen. Es ist ein sprachunabhängiges Textformat, das Konventionen verwendet, die Programmierern der C-Sprachfamilie bekannt sind, darunter C, C++, C#, Java, JavaScript, Perl und Python.
Zeitformat Für Datums- und Zeitangaben wird der Epoch-Konverter in Millisekunden verwendet. Dieses Format gilt für die Erstellungszeit des Abos, die Start- und Endzeiten der Laufzeit des Abos und die Endzeiten des kostenlosen Testzeitraums.