Limits und Kontingente schützen die Google-Infrastruktur vor einem automatisierten Prozess, bei dem die Admin Settings API auf unangemessene Weise verwendet wird. Übermäßige Anfragen von einer API können von einem harmlosen Tippfehler oder von einem ineffizienten System stammen, das unnötige API-Aufrufe durchführt. Unabhängig vom Grund ist es für den allgemeinen Zustand des Google Workspace-Systems erforderlich, Traffic von einer bestimmten Quelle zu blockieren, sobald ein bestimmtes Level erreicht wird. Dadurch wird verhindert, dass die Aktionen eines Entwicklers die gesamte Community beeinträchtigen können.
In dem unwahrscheinlichen Fall, dass Ihre API-Anfrage fehlschlägt, erhalten Sie eine HTTP-Statuscodeantwort. Der Statuscode 403 enthält Fehlerinformationen über eine falsche Eingabe und der HTTP-Statuscode 503 enthält Fehlerinformationen, die angeben, welche API-Kontingente überschritten wurden. Diese Antworten ermöglichen es Ihrer benutzerdefinierten Anwendung, diese Fehler zu erkennen und entsprechende Maßnahmen zu ergreifen.
Wenn Ihre Anfragen innerhalb eines bestimmten Zeitraums bearbeitet werden müssen, senden Sie sie parallel oder verwenden Sie mehrere Threads in Ihrer Java- oder C#-Anwendung. Sie können Ihre Anfragen beispielsweise nach Monat oder einem anderen Zeitraum aufschlüsseln. Bei Threads beginnen Sie am besten mit zehn Threads pro Anfrage. Beachten Sie, dass die Empfehlungen für einen Thread Kompromisse haben und nicht für alle API-Situationen nützlich sind. Wenn die Anzahl der Anfragen zu hoch wird, treten Kontingentfehler auf.
Bei allen zeitbasierten Fehlern (maximal N Elemente für X Sekunden pro Thread) und insbesondere von Fehlern des Statuscodes 503 empfehlen wir, dass Sie den Code als Ausnahme erfassen und mit einem exponentiellen Backoff-Algorithmus eine kleine Verzögerung abwarten, bevor Sie den fehlgeschlagenen Aufruf wiederholen. Ein Beispiel für die Email Settings API für einen Thread ist es, fünf 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 die Häufigkeit der Anfrage reduzieren, bis der Aufruf erfolgreich war. Erhöhen Sie beispielsweise die anfängliche Verzögerung von fünf Sekunden auf zehn Sekunden und versuchen Sie den fehlgeschlagenen Anruf noch einmal. Legen Sie außerdem ein Wiederholungslimit fest. Wiederholen Sie beispielsweise eine Anfrage fünf- bis siebenmal mit unterschiedlichen Verzögerungszeiten, bevor Ihre Anwendung einen Fehler an den Nutzer zurückgibt.
| API-Kontingentkategorien | Kontingente |
|---|---|
| ClientLogin-Authentifizierungstokens | 24 Stunden lang gültig. Der Fehler lautet „401 Token abgelaufen“. |
| Öffentliche und private Schlüssel generieren | Generieren Sie mit Ihrem Identitätsanbieter eine Reihe von öffentlichen und privaten Schlüsseln mithilfe des DSA- oder RSA-Algorithmus. Der öffentliche Schlüssel hat ein X.509-formatiertes Zertifikat. Weitere Informationen zur SAML-basierten Einmalanmeldung (SSO) finden Sie unter Schlüssel und Zertifikate für den Einmalanmeldungsservice (SSO) von Google Workspace generieren. |
| Logo | Die Logobilddatei eines Kontos kann im JPEG-, PNG- oder GIF-Format vorliegen. Die empfohlene Größe ist 143 × 59 Pixel und die Datei sollte kleiner als 20 KB sein. Beachten Sie bei der Nutzung von benutzerdefinierten Logos die Nutzungsbedingungen von Google. Außerdem dürfen das Google-Logo, das Gmail-Logo oder andere Google-Logos nicht verwendet werden. Weitere Informationen finden Sie in den Richtlinien für Logos und Landingpages. |
| ssoWhitelist | Eine ssoWhitelist ist eine Netzwerkmasken-IP-Adresse im CIDR-Format (Classless Inter-Domain Routing). |
| Andere Arten von Beschränkungen | Einschränkungen und Richtlinien |
|---|---|
| Bestätigungsstatus des MX-Eintrags | Der Standardstatus für die Bestätigung von MX-Einträgen ist „false“. Das bedeutet, dass die Konfiguration Ihres MX-Eintrags in letzter Zeit entweder vom Google-System nicht überprüft wurde oder Ihre MX-Einträge nicht für das Verweisen auf die Google-Systeme konfiguriert sind. Wenn Sie Ihre Einträge aktualisiert haben und der Bestätigungsstatus weiterhin falsch bleibt, wurden die MX-Einträge möglicherweise nicht übernommen oder der Eintrag enthält einen Tippfehler. Für die Übernahme empfehlen wir, die durch den TTL-Wert (Time to Live Value) festgelegte Zeitspanne abzuwarten und es dann erneut zu versuchen. |
| Ländercodes | Wenn der Name der Organisation nicht angepasst wurde, ist er standardmäßig Ihr primärer Domainname. Informationen zu Zeichen für Organisationsnamen finden Sie unter Zeichennutzung. |
creationTime-Property, numerische Darstellung von Datum und Uhrzeit |
Siehe ISO 8601, numerische Darstellung von Datum und Uhrzeit. |
| Tags zur Sprachcodierung | Von Google Mail akzeptierte RFC 3066-Sprach-Tags |
| Name der Organisation | Wenn der Name der Organisation nicht angepasst wurde, ist er standardmäßig Ihr primärer Domainname. Informationen zu Zeichen für Organisationsnamen finden Sie unter Zeichennutzung. |