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
Anfragen zum Ändern von Daten	10.000 Vorgänge pro Anfrage	TOO_MANY_MUTATE_OPERATIONS
Anfragen für die Dienstplanung	1 Abfrage 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

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

Die täglichen Limits für die API-Nutzung 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 Zugriffsebenen und zulässige Nutzung werden die spezifischen Limits für API-Vorgänge 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 zählt nicht nur auf das tägliche Vorgangskontingent des Nutzers, sondern darf auch nicht mehr als 10.000 Vorgänge pro Anfrage enthalten.

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

Paginierte Anfragen (z. B. Anfragen, die eine gültige next_page_token enthalten) werden nicht auf das tägliche Betriebskontingent eines Nutzers angerechnet. Paginierungsanfragen mit einem abgelaufenen oder ungültigen Seiten-Token führen jedoch zu einer Ausnahme und werden auf das tägliche Betriebskontingent 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 keine GoogleAdsFailure zurückgeben, z. B. aufgrund eines Fehlers auf Netzwerkebene, werden nicht auf das tägliche Betriebskontingent des Nutzers angerechnet, da die Anfragen den Dienst nie erreichen. Ein Beispiel hierfür ist ein Netzwerkverbindungsfehler.

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	Maximale Anzahl
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

• Sie sind auf 2.000 Conversion-Anpassungen pro Anfrage beschränkt:

  • 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 Fehler TOO_MANY_MUTATE_OPERATIONS abgelehnt.

• Zwischen Änderungen der Budgetreihenfolge für dasselbe Konto sollten Sie mindestens 12 Stunden warten. 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 E-Mail-Einladungen an andere Nutzer gesendet werden, besteht die Gefahr von Missbrauch. Daher gibt es Einschränkungen:

• 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 der Fehler OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS oder UserDataError.TOO_MANY_USER_IDENTIFIERS zurückgegeben, wenn ein UserData-Set mehr als 20 user_identifiers enthält.

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 feststellen und Anfragen mit einem wiederkehrenden Feld senden, 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.