API-Limits und -Kontingente

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

Anfragetyp, Einschränkung und Fehlercode
Vorgänge mit der Zugriffsebene „Einfacher Zugriff“	15.000 API-Vorgänge pro Tag	RESOURCE_EXHAUSTED
Mutationsanfragen	10.000 Vorgänge pro Anfrage	TOO_MANY_MUTATE_OPERATIONS
Planung von Dienstanfragen	1 QPS	RESOURCE_EXHAUSTED
Anfragen an den Conversion Upload Service	2.000 Conversions pro Anfrage	TOO_MANY_CONVERSIONS_IN_REQUEST
Serviceanfragen für Abrechnung und Kontobudget	1 Vorgang pro Änderungsanfrage	TOO_MANY_MUTATE_OPERATIONS

Tägliche API-Vorgangslimits

Die täglichen API-Nutzungslimits basieren auf der Anzahl der API-Vorgänge pro Entwicklertoken. API-Vorgänge sind die Gesamtsumme der GET-Anfragen und Mutate-Vorgänge. Die Limits für tägliche API-Vorgänge hängen vom Zugriffsniveau des Entwicklertokens ab. Im Leitfaden zu Zugriffsebenen und zulässiger Nutzung finden Sie die spezifischen API-Vorgangslimits für jede Zugriffsebene.

Anfragen, die diese Limits überschreiten, werden mit dem Fehler RESOURCE_EXHAUSTED abgelehnt.

gRPC-Einschränkungen

Alle Clientbibliotheken der Google Ads API verwenden gRPC zum Generieren von Anfragen und Antworten. Standardmäßig ist die Nachrichtengröße in gRPC auf 4 MB begrenzt. In unseren Clientbibliotheken ist die maximale Nachrichtengröße jedoch auf 64 MB festgelegt, 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 umgehen, können Sie die Anzahl der ausgewählten Felder reduzieren oder Streaming verwenden. Senden Sie bei Mutationen weniger Vorgänge pro Anfrage.

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

Mutationsanfragen

Eine Mutate-Anfrage wird nicht nur auf das tägliche Vorgangskontingent des Nutzers angerechnet, 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 zusätzliche Einschränkungen und Überlegungen für bestimmte Dienste und Anfragetypen beschrieben.

Suchanfragen

Eine Search- oder SearchStream-Anfrage wird als ein Vorgang auf das tägliche Vorgangskontingent des Nutzers angerechnet. Eine SearchStream-Anfrage wird unabhängig von der Anzahl der Batches als ein API-Vorgang gezählt.

Paginierte Anfragen

Paginierte Anfragen (z. B. Anfragen, die ein gültiges next_page_token enthalten) werden nicht auf das tägliche Betriebskontingent eines Nutzers angerechnet. Bei Paginierungsanfragen mit einem abgelaufenen oder ungültigen Seitentoken wird jedoch eine Ausnahme generiert und die Anfrage wird auf das tägliche Vorgangskontingent angerechnet.

Weitere Informationen zur Paginierung finden Sie unter Ergebnisse ansehen.

Andere Arten von Anfragen

Eine Anfrage, die keine Get-, Mutate-, Search- oder SearchStream-Anfrage ist, wird als ein Vorgang auf das tägliche Vorgangskontingent 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 weiterhin auf das tägliche Vorgangskontingent des Nutzers angerechnet.

Anfragen, die fehlschlagen, aber keinen 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. Ein Beispiel hierfür ist ein Fehler bei der Netzwerkverbindung.

Keyword-Planungsservice

Aus Kostengründen und aufgrund der Komplexität unterliegen die folgenden Methoden des Keyword-Planungsservice separaten Beschränkungen im Vergleich zu anderen Arten von Anfragen.

• Beschränkt auf eine 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.

• Beschränkt auf 2 Anfragen pro Sekunde und Kundennummer:

  • KeywordPlanIdeaService.GenerateAdGroupTheme

Beachten Sie diese Beschrä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

Dienst für Zielgruppeninformationen

Die folgenden Methoden innerhalb von AudienceInsightsService-Methoden unterliegen bestimmten Kontingentlimits.

• Beschränkt auf ca. 200 Anfragen pro Tag und CID:

  • AudienceInsightsService.generateAudienceCompositionInsights
  • AudienceInsightsService.generateSuggestedTargetingInsights

• Beschränkt auf 2 Anfragen pro Sekunde und Entwicklertoken:

  • AudienceInsightsService.generateTargetingSuggestionMetrics

Dienst zum Hochladen von Conversions

• Beschränkt auf 2.000 Anruf- oder Conversion-Klicks pro Anfrage:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

  Anfragen, die diese Limits überschreiten, werden mit dem Fehler TOO_MANY_CONVERSIONS_IN_REQUEST abgelehnt.

Dienst zum Hochladen von Conversion-Anpassungen

• Beschränkt auf 2.000 Conversion-Anpassungen pro Anfrage:

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

  Anfragen, die diese Limits überschreiten, 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 Mutate-Anfragen ist nur ein Vorgang zulässig.

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

• Zwischen Änderungen an Budgetaufträgen für dasselbe Konto sollten mindestens 12 Stunden liegen. Wenn Sie Änderungen vornehmen, bevor 12 Stunden vergangen sind, kann es zu nicht behebbaren Fehlern kommen, die nur von Ihrem Google Ads-Kontobetreuer behoben werden können.

Einladungen für Kundenkonten

Neue Nutzer können mit der CustomerUserAccessService in bestehende Kundenkonten eingeladen werden. Da mit dieser Funktion Einladungs-E-Mails an andere Nutzer gesendet werden, besteht die Gefahr, dass sie missbraucht wird. Daher gibt es Einschränkungen bei der Funktionsweise:

• 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, der bereits eine ausstehende Einladung hat, wird dieser Fehler zurückgegeben: ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.

• In Kundenkonten können nicht mehr als 70 Einladungen gleichzeitig ausstehen. Wenn eine Anfrage gesendet wird, die dazu führt, dass 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 UserData-Vorgang zum Erstellen oder Entfernen sollte jeder Satz von user_identifiers für einen einzelnen Nutzer spezifisch sein.

Um dies zu erzwingen, wird ein Fehler vom Typ OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS oder UserDataError.TOO_MANY_USER_IDENTIFIERS zurückgegeben, wenn ein UserData-Satz mehr als 20 user_identifiers enthält.

Sie dürfen bis zu 100.000 Nutzerkennungen verwenden,unabhängig von der Anzahl der Vorgänge.

Andere Arten von Limits

Ein wiederkehrendes Feld, z. B. eine Liste von Vorgängen, das zu viele Elemente in einer Anfrage enthält, kann den Fehler REQUEST_SIZE_LIMIT_EXCEEDED verursachen. Diese Fehlermeldung kann auch durch andere Probleme verursacht werden.

Wenn Sie auf diese Einschränkung stoßen und Anfragen mit einem wiederkehrenden Feld stellen, versuchen Sie, die Anzahl der Elemente im wiederkehrenden Feld zu reduzieren, indem Sie eine Liste von Vorgängen in einer Mutate-Anfrage bereitstellen.

Bei einer GAQL-Abfrage beträgt die maximale Anzahl von Elementen in einer IN-Klausel 20.000. Wenn Sie dieses Limit überschreiten, wird der Fehler FILTER_HAS_TOO_MANY_VALUES zurückgegeben.