Limits und Kontingente schützen die Google-Infrastruktur vor einem automatisierten Prozess, bei dem die Reseller 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 ausfü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, wenn dieser ein bestimmtes Niveau erreicht. Sie sorgt dafür, dass die Aktionen eines Entwicklers keine negativen Auswirkungen auf die gesamte Community haben können.
Fehler bei API-Anfragen
Im unwahrscheinlichen Fall, dass Ihre API-Anfrage fehlschlägt, erhält Ihre Anwendung eine HTTP-Statuscodeantwort. Der Statuscode 403 enthält Fehlerinformationen zu falschen Eingaben 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.
Zeitbasierte Fehler
Bei allen zeitbasierten Fehlern (maximal N Dinge für N Sekunden pro Thread), insbesondere die Fehler 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 Reseller API-Beispiel für einen Thread ist das Warten von 5 Sekunden und das Wiederholen des fehlgeschlagenen Aufrufs. 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 reduzieren, 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 noch einmal. Legen Sie außerdem ein Limit für die Wiederholung fest.
Beispielsweise können Sie eine Anfrage fünf- bis siebenmal mit unterschiedlichen Verzögerungszeiten wiederholen, bevor die Anwendung einen Fehler an den Nutzer zurückgibt.
Einschränkungen
| API-Limitkategorien | Einschränkungen |
|---|---|
Abo purchaseOrderId |
Für diese Eigenschaft sind bis zu 80 Textzeichen zulässig. |
Abo maxResults |
Der Abfragestring maxResults kann 1 bis 100 Ergebnisse umfassen.
Der Standardwert ist 20 Ergebnisse.
|
Übertragungstoken (customerAuthToken) |
Das Übertragungstoken eines Kunden ist nach seiner Generierung 30 Tage lang gültig. |
| Maximale Nutzerzahl pro Kunde | Abhängig von Ihrem Vertrag kann die maximale Anzahl der Nutzer entweder 50.000 oder die in Ihrem Reseller-Vertrag festgelegte Höchstzahl betragen. |
| Nicht autorisierte Anfragen | Google gestattet keine nicht autorisierten Anfragen an die Reseller API. Eine Anfrage gilt als nicht autorisiert, wenn kein Autorisierungstoken angegeben wird. Weitere Informationen finden Sie unter Informationen zur Authentifizierung und Autorisierung. |
Andere Arten von Limits
| Andere Arten von Limits | Beschränkungen und Richtlinien |
|---|---|
| Datenformat |
Das Datenformat ist JSON von JavaScript Object Notation.
JSON ist ein gängiges Internetformat, das eine Methode zur Darstellung beliebiger Datenstrukturen bietet. JSON ist ein Textformat, das vollständig sprachunabhängig ist, aber Konventionen verwendet, die Programmierern der C-Familie vertraut sind, einschließlich C, C++, C#, Java, JavaScript, Perl und Python. |
| Uhrzeitformat | Alle Datumszeiten werden im Epochen-Converter in Millisekunden angegeben. Dieses Format gilt für die Werte für den Erstellungszeitpunkt des Abos, den Beginn und das Ende der Zusicherung eines Tarifs und das Ende eines 30-tägigen kostenlosen Testzeitraums. |