Durch Limits und Kontingente wird die Google-Infrastruktur vor automatisierten Prozessen geschützt, die die Admin Settings API auf unangemessene Weise verwenden. Übermäßige Anfragen von einer API können auf einen harmlosen Tippfehler oder auf ein ineffizient konzipiertes System zurückzuführen sein, das unnötige API-Aufrufe ausführt. Unabhängig von der Ursache ist es für die allgemeine Integrität des Google Workspace-Systems erforderlich, den Traffic von einer bestimmten Quelle zu blockieren, sobald er ein bestimmtes Niveau erreicht. So wird sichergestellt, dass die Handlungen eines Entwicklers keine negativen Auswirkungen auf die gesamte Community haben.
Sollte Ihre API-Anfrage fehlschlagen, erhalten Sie eine Antwort mit einem HTTP-Statuscode. Der Statuscode 403 enthält Fehlerinformationen zu einer fehlerhaften Eingabe und der HTTP-Statuscode 503 enthält Fehlerinformationen dazu, 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 abgeschlossen 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 aufteilen. Bei Threads sollten Sie mit 10 Threads beginnen, also einem Thread pro Anfrage. Beachten Sie, dass die Thread-Empfehlung Vor- und Nachteile hat und nicht für alle API-Situationen nützlich ist. Wenn die Anzahl der Anfragen zu hoch wird, treten Kontingentfehler auf.
Bei allen zeitbasierten Fehlern (maximal N Dinge für X Sekunden pro Thread), insbesondere bei Fehlern mit dem Statuscode 503, empfehlen wir, die Ausnahme im Code abzufangen und mit einem exponentiellen Backoff-Algorithmus eine kurze Verzögerung abzuwarten, bevor der fehlgeschlagene Aufruf wiederholt wird. Ein Beispiel für die Email Settings API für einen Thread ist, 5 Sekunden zu warten und den fehlgeschlagenen Aufruf dann noch einmal zu versuchen. 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 Anfragen 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. Legen Sie außerdem ein Limit für Wiederholungsversuche fest. Wiederholen Sie eine Anfrage beispielsweise 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 expired“. |
| Öffentliche und private Schlüssel generieren |
Generieren Sie mit Ihrem Identitätsanbieter einen Satz öffentlicher und privater Schlüssel mit dem DSA- oder RSA-Algorithmus. Der öffentliche Schlüssel befindet sich in einem X.509-Zertifikat. Weitere Informationen zu SAML-basierten Signaturschlüsseln für die Einmalanmeldung finden Sie unter Schlüssel und Zertifikate für den Google Workspace-Dienst für die Einmalanmeldung 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. Wenn Sie benutzerdefinierte Logos verwenden, müssen Sie die Google-Nutzungsbedingungen einhalten. Verwenden Sie nicht das Google-Logo, das Gmail-Logo oder andere Logos von Google. 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 Limits | 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 entweder das Google-System Ihre MX-Eintrags-Konfiguration in letzter Zeit nicht überprüft hat oder Ihre MX-Einträge nicht so konfiguriert wurden, dass sie auf die Google-Systeme verweisen. Wenn Sie Ihre Einträge aktualisiert haben und der Bestätigungsstatus weiterhin „false“ ist, wurden Ihre MX-Eintragsaktualisierungen möglicherweise nicht weitergegeben oder der Eintrag enthält einen Tippfehler. Wir empfehlen, die im TTL-Wert (Time To Live) des MX-Eintrags definierte Zeit abzuwarten und es dann noch einmal zu versuchen. |
| Ländercodes |
Wenn der Name der Organisation nicht angepasst wurde, wird standardmäßig der Name Ihrer primären Domain verwendet. Informationen zu Zeichen für Organisationsnamen finden Sie unter Zeichenverwendung. |
creationTime-Attribut, numerische Darstellung von Datum und Uhrzeit |
Weitere Informationen finden Sie unter ISO 8601, Numerische Darstellung von Datum und Uhrzeit. |
| Tags für die Sprachcodierung |
Sehen Sie sich die von Google Mail akzeptierten RFC 3066-Sprach-Tags an. |
| Name der Organisation |
Wenn der Name der Organisation nicht angepasst wurde, wird standardmäßig der Name Ihrer primären Domain verwendet. Informationen zu Zeichen für Organisationsnamen finden Sie unter Zeichenverwendung. |
Kontingenterhöhung für einzelne Projekte anfordern
Abhängig von der Ressourcennutzung Ihres Projekts möchten Sie möglicherweise eine Kontingentanpassung anfordern. API-Aufrufe durch ein Dienstkonto werden so behandelt, als würden sie von einem einzelnen Konto stammen. Wenn Sie ein angepasstes Kontingent beantragen, bedeutet dies nicht, dass Ihr Antrag auch genehmigt wird. Anfragen zur Kontingentanpassung, die den Kontingentwert erheblich erhöhen würden, können länger dauern, bis sie genehmigt werden.
Es gelten nicht für alle Projekte dieselben Kontingente. Wenn Sie Google Cloud mit der Zeit stärker nutzen, müssen Ihre Kontingentwerte möglicherweise erhöht werden. Falls Sie eine deutlich stärkere Auslastung erwarten, können Sie auf der Seite Kontingente und Systemlimits der Google Cloud Console eine Anpassung Ihres Kontingents anfordern.
Weitere Informationen finden Sie in folgenden Dokumenten: