API-Nutzung deckeln

Je nach API können Sie Anfragen explizit begrenzen, indem Sie Anfragen pro Tag, Anfragen pro Minute oder Anfragen pro Minute pro Nutzer.

Es kann sinnvoll sein, die kostenpflichtige Nutzung durch Festlegen von Obergrenzen zu beschränken. Wenn Sie beispielsweise verhindern möchten, dass Ihnen Anfragen berechnet werden, die das Limit für die kostenlose Nutzung überschreiten, können Sie eine Obergrenze für die Anfragen pro Tag festlegen.

Wichtig: Kontingentlimits sind nicht immer vollständig genau, da es zu einer Latenz zwischen dem Überschreiten eines Kontingents und dem Beginn der Erzwingung kommt. Wenn Sie Kontingente als Tool verwenden, um die Abrechnung zu begrenzen, müssen Sie Puffer zulassen.

Limits für die Anzahl von Anfragen ansehen und ändern

Sie können für alle Anfragen an eine abrechnungsfähige API Grenzen ein Limit angeben. Die meisten APIs legen Standardlimits fest. Sie können dieses Limit jedoch bis zu einem von Google festgelegten Maximum ändern. Das Limit mancher APIs bleibt niedrig, bis Sie die Abrechnung für Ihr Projekt aktivieren.

Führen Sie folgende Schritte aus, um die Limits für Ihre API aufzurufen oder zu ändern:

1. Rufen Sie in der Google Cloud Console die Seite Dashboard „APIs & Dienste“ auf.

   Dashboard "APIs & Dienste" aufrufen

2. Wählen Sie aus der Projektliste ein Projekt aus oder erstellen Sie ein neues.
3. Klicken Sie auf den Namen der jeweiligen API.
4. Klicken Sie auf Kontingente. Wenn der Tab Kontingente nicht in der Tabnavigation angezeigt wird, bedeutet das, dass für die ausgewählte API keine Kontingente definiert sind.
5. Um das Kontingent zu ermitteln, das Sie beschränken möchten, geben Sie die entsprechenden Attribute und Werte in das Feld Filter ein. Geben Sie beispielsweise Kontingent:Subnetzwerke ein, um das Kontingent Subnetzwerke zu ermitteln.
6. Klicken Sie auf das Kästchen neben dem Kontingent, das Sie beschränken möchten, und dann auf KONTINGENTE BEARBEITEN.
7. Füllen Sie das Formular für die Kontingentänderung aus, einschließlich des neuen Limits, das Sie festlegen möchten.
8. Klicken Sie auf Anfrage senden.

Für einige APIs können Sie ein Formular senden, um ein höheres Limit anzufordern. Bei einigen APIs können Sie nur dann ein höheres Kontingent angeben, wenn die Abrechnung für das Projekt aktiviert ist.

Hinweis: Abrechnungsfähige Tageslimits lassen sich nur für kostenpflichtige APIs festlegen und in manchen Fällen auch nur dann, wenn die Abrechnung für Ihr Projekt aktiviert ist. Wenn keine kostenpflichtigen APIs in Ihrem Projekt verwendet werden, können Sie keine Tageslimits festlegen. Weitere Informationen zu Rechnungskonten finden Sie unter Cloud-Rechnungskonto erstellen, ändern oder schließen.

Die Abschnitte zu Kontingenten der Premiumoption gelten für die Google Maps-Premiumoption, die nicht mehr angeboten wird. Bearbeiten Sie diese Abschnitte nur, wenn Sie bereits Kunde der Google Maps-Premiumoption sind.

Anfragen pro Nutzer beschränken

Um zu verhindern, dass einzelne Nutzer Ihr API-Kontingent aufbrauchen, gibt es in einigen APIs ein Limit pro Nutzer und Minute.

Wenn Sie prüfen möchten, ob Ihre API ein Standardlimit pro Nutzer und Minute hat, suchen Sie in Ihren API-Kontingenten wie in der Anleitung unter Limits für die Anzahl der Anfragen ansehen und ändern beschrieben. Wenn ein solches Standardlimit für diese API vorhanden ist, können Sie diesen Wert ändern, um das für jeden Nutzer verfügbare Kontingent zu begrenzen. Folgen Sie dazu der Anleitung in diesem Artikel. Wenn Ihre API dieses Standardlimit nicht in ihre Kontingente einschließt, können Sie durch Hinzufügen oder Änderungen daran nicht unterstützt werden.

Einzelne Nutzer werden durch einen eindeutigen String identifiziert. Wenn Sie eine serverseitige Anwendung verwenden, bei der der aufrufende Code auf einem die Anfragen im Namen von Nutzern stellt, sowie Ihre Anfragen an die API, Sie müssen den Parameter quotaUser enthalten. Dieser Parameter ist in der Dokumentation zu Systemparametern definiert.

Hinweis: Obwohl nutzerbasierte Limits in Abfragen pro Minute angegeben werden, sind kurzzeitige Nutzungsspitzen zulässig. Legen Sie also Limits auf Basis des durchschnittlichen Trafficaufkommens fest. Wenn ein Nutzer versucht, eine API über diese Einstellungen hinaus zu verwenden, lösen die Anfragen einen Limit-überschritten-Fehler aus.

Zum Identifizieren eines Nutzers verwenden Sie den URL-Suchparameter quotaUser=userID. Dieser Wert gilt nur für die kurzfristige Erzwingung von Kontingenten, sodass Sie keine echte Nutzer-ID angeben müssen. Um einen Nutzer eindeutig zu identifizieren, können Sie einen beliebigen String verwenden. Der String ist jedoch auf 40 Zeichen begrenzt.

Der Parameter quotaUser wird nur zum Deckeln von Anfragen pro Nutzer und Minute verwendet. Wenn Sie den Parameter quotaUser nicht senden, werden alle Aufrufe Ihren Servercomputern zugeordnet. In diesem Fall können Aufrufe nicht vom Nutzer begrenzt werden.

Wenn Ihre API kein standardmäßiges Limit pro Nutzer und Minute vorsieht, dann quotaUser-Werte werden ignoriert.

Wichtig: Achten Sie beim Senden von Nutzer-IDs darauf, dass alle lokalen Gesetze eingehalten werden, einschließlich Gesetze in Bezug auf die Offenlegung personenbezogener Daten, die Sie mit jeder Anfrage senden. Es empfiehlt sich, so wenig personenbezogene Daten wie möglich anzugeben.

Alle Kontingente für APIs in einem Projekt aufrufen und bearbeiten

Sie können Kontingentlimits für alle abrechenbaren APIs in einem bestimmten Projekt überprüfen und bearbeiten sowie eine Erhöhung der Kontingentlimits anfordern. Rufen Sie dazu die Seite Kontingente im Abschnitt IAM und Verwaltung der Google Cloud Console auf.

Führen Sie folgende Schritte aus, um Kontingente für alle kostenpflichtigen APIs in Ihrem Projekt aufzurufen und zu bearbeiten:

1. Öffnen Sie in der Google Cloud Console die Seite Kontingente.

   Kontingente aufrufen

2. Wählen Sie aus der Projektliste ein Projekt aus oder erstellen Sie ein neues. Die Seite Kontingente wird für das ausgewählte Projekt angezeigt. Jeder Kontingenttyp, der in den einzelnen Diensten verfügbar ist, wird in einer eigenen Zeile aufgeführt.
3. Klicken Sie auf Filtertabelle von , um Ihr Kontingent anhand eines bestimmten Attributs abzufragen.
4. Klicken Sie auf die Kästchen neben den Kontingenten, die Sie bearbeiten möchten. Die Abrechnung muss für das Projekt aktiviert sein, damit Sie auf einige der .
   Wenn Sie alle Kontingente für eine bestimmte API bearbeiten möchten, klicken Sie auf den Namen des Dienstes, um die Seite "Kontingente" für diese API aufzurufen.
5. Klicken Sie auf KONTINGENTE BEARBEITEN.
6. Maximieren Sie im angezeigten Bereich Kontingentänderungen die Dienstansicht, bearbeiten Sie dann die Kontingente in diesem Dienst nach Bedarf und klicken Sie auf FERTIG.
7. Wiederholen Sie diese Schritte, um die Kontingente in jedem der ausgewählten Dienste zu bearbeiten.
   • Die aktuellen Kontingentlimits sind in den Eingabefeldern vorab ausgefüllt.
   • Ein Dienst mit einem Warnsymbol () beim Senden hat Eingabefehler.
   • Zum Bearbeiten weiterer Kontingente können Sie diese wie oben beschrieben auswählen.
   • Sie können einen Dienst aus dem Bereich Kontingentänderungen entfernen. Dazu bewegen Sie den Mauszeiger auf die nicht erweiterte Dienstansicht und klicken auf das Löschsymbol ().
8. Klicken Sie auf WEITER, wenn Sie mit dem Bearbeiten der Kontingente fertig sind.
9. Wenn Ihre Anfrage zur Kontingentbearbeitung überprüft werden muss, wird das Formular Kontaktdetails angezeigt. Füllen Sie das Formular mit Ihren Kontaktdaten aus.
10. Klicken Sie auf ANFRAGE SENDEN.