Durch Limits und Kontingente wird die Google-Infrastruktur vor automatisierten Prozessen geschützt, die die Reseller API unangemessen verwenden. Eine übermäßige Anzahl von Anfragen kann durch einen Tippfehler oder ein ineffizient gestaltetes System verursacht werden. Um die Integrität des Google Workspace-Systems zu gewährleisten, blockiert Google Traffic von bestimmten Quellen, wenn er bestimmte Werte erreicht. So wird sichergestellt, dass die Aktionen eines Entwicklers keine negativen Auswirkungen auf die Community haben.
Fehler bei API-Anfragen
Wenn eine API-Anfrage fehlschlägt, erhält Ihre Anwendung einen HTTP-Statuscode. Der Statuscode 403 weist auf eine falsche Eingabe hin und der Statuscode 503 darauf, dass API-Kontingente überschritten wurden. Anhand dieser Antworten können Sie Fehler erkennen und Maßnahmen ergreifen.
Zeitbasierte Fehler
Verwenden Sie für zeitbasierte Fehler, insbesondere 503-Statuscodes, einen exponentiellen Backoff-Algorithmus. Warten Sie kurz, bevor Sie den fehlgeschlagenen Anruf noch einmal versuchen. Warten Sie beispielsweise 5 Sekunden und versuchen Sie es dann noch einmal. Wiederholen Sie das Muster bei Erfolg 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 Wiederholungslimit festzulegen, z. B. 5- bis 7-mal.
Limits
| API-Limitkategorien | Limits |
|---|---|
Abo purchaseOrderId |
Diese Property akzeptiert bis zu 80 Nur-Text-Zeichen. |
Abo maxResults |
Der Abfragestring maxResults kann 1–100 Ergebnisse enthalten.
Der Standardwert sind 20 Ergebnisse.
|
Übertragungstoken (customerAuthToken) |
Das Übertragungstoken eines Kunden ist nach der Generierung 30 Tage lang gültig. |
| Maximale Nutzerzahl für einen Kunden | Je nach Vertrag kann die maximale Anzahl von Nutzern 50.000 oder die in Ihrem Resellervertrag definierte maximale Anzahl betragen. |
| Nicht autorisierte Anfragen | Google lässt keine unautorisierten Anfragen an die Reseller API zu. Eine Anfrage ist nicht autorisiert, wenn kein Autorisierungstoken angegeben ist. 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 Datenstrukturen. Es ist ein sprachunabhängiges Textformat, das Konventionen verwendet, die Programmierern der C-Sprachfamilie vertraut sind, darunter C, C++, C#, Java, JavaScript, Perl und Python. |
| Zeitformat | Für Datums- und Uhrzeitwerte wird der Epochenkonverter in Millisekunden verwendet. Dieses Format gilt für die Erstellungszeit des Abos, die Start- und Endzeiten der Mindestlaufzeit des Abos und die Endzeiten des kostenlosen Testzeitraums. |