API-Limits und Kontingente

Die Google Ads API erzwingt Limits für API-Vorgänge, z. B. die Anzahl der Vorgänge, die in einer einzelnen Änderungsanfrage gesendet werden können. In der folgenden Tabelle sind einige wichtige Limits und Kontingente zusammengefasst.

Anfragetyp, Einschränkung und Fehlercode
Vorgänge mit grundlegendem Zugriff	15.000 API-Vorgänge pro Tag	RESOURCE_EXHAUSTED
Änderungsanträge	10.000 Vorgänge pro Anfrage	TOO_MANY_MUTATE_OPERATIONS
Anfragen für die Dienstplanung	1 Abfragen pro Sekunde	RESOURCE_EXHAUSTED
Anfragen an den Conversion-Upload-Dienst	2.000 Conversions pro Anfrage	TOO_MANY_CONVERSIONS_IN_REQUEST
Anfragen an den Abrechnungs- und Kontobudgetdienst	1 Vorgang pro Änderungsanfrage	TOO_MANY_MUTATE_OPERATIONS

Tägliche Limits für API-Vorgänge

Die täglichen API-Nutzungslimits basieren auf der Anzahl der API-Vorgänge pro Entwicklertoken. API-Vorgänge sind die Gesamtzahl der Get-Anfragen und Mutavorgängen. Die Limits für tägliche API-Vorgänge hängen von der Zugriffsebene des Entwicklertokens ab. Im Leitfaden zu Zugriffsebenen und zulässiger Nutzung werden die jeweiligen API-Vorgangslimits für jede Zugriffsebene beschrieben.

Anfragen, die gegen diese Limits verstoßen, werden mit dem Fehler RESOURCE_EXHAUSTED abgelehnt.

gRPC-Einschränkungen

Alle Clientbibliotheken der Google Ads API verwenden gRPC, um Anfragen und Antworten zu generieren. Standardmäßig hat gRPC eine Nachrichtengröße von 4 MB. Unsere Clientbibliotheken legen jedoch eine maximale Nachrichtengröße von 64 MB fest, um die Effizienz zu steigern.

Antworten dürfen dieses Limit nicht überschreiten. Eine Suchanfrage mit vielen Feldern kann beispielsweise eine Antwort generieren, die größer als 64 MB ist. Um dieses Limit zu vermeiden, können Sie die Anzahl der ausgewählten Felder reduzieren oder Streaming verwenden. Senden Sie bei Mutaten weniger Vorgänge pro Anfrage.

Bei Anfragen, die gegen diese Einschränkung verstoßen, wird kein GoogleAdsError, sondern ein 429 Resource Exhausted-gRPC-Fehler generiert. Weitere Informationen finden Sie in der Liste der gRPC-Fehlercodes und ‑meldungen.

Anfragen zum Ändern von Daten

Eine mutate-Anfrage kann nicht mehr als 10.000 Vorgänge pro Anfrage enthalten und nicht nur auf das tägliche Vorgangskontingent des Nutzers angerechnet werden.

Anfragen, die gegen diese Einschränkung verstoßen, werden mit dem Fehler TOO_MANY_MUTATE_OPERATIONS abgelehnt.

Im Folgenden werden weitere Einschränkungen und Hinweise für bestimmte Dienste und Anfragetypen beschrieben.

Suchanfragen

Eine Search- oder SearchStream-Anfrage wird dem täglichen Vorgangskontingent des Nutzers als ein Vorgang angerechnet. Eine SearchStream-Anfrage zählt unabhängig von der Anzahl der Batches als ein API-Vorgang.

Paginierte Anfragen

Anfragen in fortlaufender Sequenz (z. B. Anfragen mit einem gültigen next_page_token) werden nicht auf das tägliche Vorgangskontingent eines Nutzers angerechnet. Paginierungsanfragen, die ein abgelaufenes oder ungültiges Seitentoken enthalten, erzeugen jedoch eine Ausnahme und werden auf das tägliche Vorgangskontingent angerechnet.

Weitere Informationen zur Paginierung finden Sie unter In Ergebnissen suchen.

Andere Arten von Anfragen

Eine Anfrage, die keine Get-, Mutate-, Search- oder SearchStream-Anfrage ist, wird als ein Vorgang auf das tägliche Kontingent des Nutzers angerechnet.

Beispiele für solche Anfragen:

• BatchJobService.ListMutateJobResults
• ConversionUploadService.UploadCallConversions
• ConversionUploadService.UploadClickConversions
• OfflineUserDataJobService.AddOfflineUserDataJobOperations
• OfflineUserDataJobService.CreateOfflineUserDataJob
• UserDataService.UploadUserData

Anfragen, die API-Ausnahmen zurückgeben

Anfragen, die mit GoogleAdsFailure abgelehnt werden, werden auf das Tageskontingent des Nutzers angerechnet.

Anfragen, die fehlschlagen, aber kein GoogleAdsFailure zurückgeben, z. B. aufgrund eines Fehlers auf Netzwerkebene, werden nicht auf das tägliche Vorgangskontingent des Nutzers angerechnet, da die Anfragen den Dienst nie erreichen würden. Ein Beispiel hierfür ist ein Ausfall der Netzwerkverbindung.

Planungsdienste

Aufgrund von Kosten und Komplexität gelten für die folgenden Planungsdienstmethoden separate Limits, die von anderen Arten von Anfragen abweichen.

• Begrenzt auf 1 Anfrage pro Sekunde und Kundennummer:

  • KeywordPlanIdeaService.GenerateKeywordIdeas
  • KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
  • KeywordPlanIdeaService.GenerateKeywordForecastMetrics

  Anfragen, die gegen diese Einschränkungen verstoßen, werden mit dem Fehler RESOURCE_EXHAUSTED abgelehnt.

• 1 QPS entspricht 60 Anfragen pro 60 Sekunden.

• Begrenzt auf 2 Anfragen pro Sekunde und Kundennummer:

  • KeywordPlanIdeaService.GenerateAdGroupTheme

Beachten Sie diese Einschränkungen beim Erstellen eines Keyword-Plans.

Keyword-Plan-Objekt	Höchstanzahl
KeywordPlan pro Konto	10.000
KeywordPlanAdGroup pro KeywordPlan	200
KeywordPlanAdGroupKeyword pro KeywordPlan	10.000
KeywordPlanCampaignKeyword (auszuschließende Keywords)	1.000
KeywordPlanCampaign pro KeywordPlan	1

Conversion-Uploaddienst

• Begrenzt auf 2.000 Anruf- oder Klick-Conversions pro Anfrage:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

  Anfragen, die gegen diese Limits verstoßen, werden mit dem Fehler TOO_MANY_CONVERSIONS_IN_REQUEST abgelehnt.

Uploaddienst für Conversion-Anpassungen

• Begrenzt auf 2.000 Conversion-Anpassungen pro Anfrage:

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

  Anfragen, die gegen diese Limits verstoßen, werden mit dem Fehler TOO_MANY_ADJUSTMENTS_IN_REQUEST abgelehnt.

Abrechnungs- und Kontobudgetdienste

• Änderungen können nur für Konten vorgenommen werden, die für die monatliche Rechnungsstellung konfiguriert sind.

  Anfragen, die gegen diese Einschränkung verstoßen, werden mit dem Fehler MUTATE_NOT_ALLOWED abgelehnt.

• Für Mutanfragen ist nur 1 Vorgang zulässig.

  Anfragen, die gegen diese Einschränkung verstoßen, werden mit dem folgenden Fehler abgelehnt: TOO_MANY_MUTATE_OPERATIONS.

• Zwischen Budgetauftragsänderungen im selben Konto sollten mindestens 12 Stunden liegen. Wenn Sie vor Ablauf der 12 Stunden Änderungen vornehmen, kann das zu nicht wiederherstellbaren Fehlern führen, die nur von Ihrem Google Ads-Kundenbetreuer behoben werden können.

Einladungen zu Kundenkonten

Neue Nutzer können mit der CustomerUserAccessService zu bestehenden Kundenkonten eingeladen werden. Da mit dieser Funktion Einladungs-E-Mails an andere Nutzer gesendet werden, kann sie missbraucht werden, was zu Einschränkungen führt:

• Nutzer können nicht mehr als eine ausstehende Einladung für dasselbe Kundenkonto erhalten. Wenn eine nachfolgende Anfrage zum Senden einer Einladung an einen Nutzer gestellt wird, für den bereits eine ausstehende Einladung vorliegt, wird dieser Fehler zurückgegeben: ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.

• Für Kundenkonten können nicht mehr als 70 Einladungen gleichzeitig ausstehend sein. Wenn eine Anfrage gesendet wird, durch die dieser Wert überschritten wird, wird dieser Fehler zurückgegeben: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.

Nutzerdaten

Nutzerdaten werden mit UserDataService und OfflineUserDataJobService verwaltet. Bei einem bestimmten Vorgang zum Erstellen oder Entfernen von UserData sollte jeder Satz von user_identifiers auf einen einzelnen Nutzer bezogen sein.

Um dies zu erzwingen, wird ein OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS- oder UserDataError.TOO_MANY_USER_IDENTIFIERS-Fehler zurückgegeben, wenn mehr als 20 user_identifiers in einem UserData-Satz vorhanden sind.

Andere Arten von Limits

Wenn ein wiederkehrendes Feld, z. B. eine Liste von Vorgängen, zu viele Elemente in einer Anfrage enthält, kann der Fehler REQUEST_SIZE_LIMIT_EXCEEDED auftreten. Diese Fehlermeldung kann auch andere Ursachen haben.

Wenn Sie diese Einschränkung bei Anfragen mit einem wiederkehrenden Feld feststellen, versuchen Sie, die Anzahl der Elemente im wiederkehrenden Feld zu reduzieren, indem Sie eine Liste von Vorgängen in einer Anfrage zum Ändern von Daten einfügen.

Bei einer GAQL-Abfrage darf eine IN-Klausel maximal 20.000 Elemente enthalten. Wird dieses Limit überschritten, wird der Fehler FILTER_HAS_TOO_MANY_VALUES zurückgegeben.