API-Limits und Kontingente

Bei der Google Ads API gelten für API-Vorgänge bestimmte Limits, beispielsweise die Anzahl der Vorgänge. die in einer einzelnen mutate-Anfrage gesendet werden können. In der folgenden Tabelle erhalten Sie und Kontingente kennen, die Sie kennen sollten.

Anfragetyp, Einschränkung und Fehlercode
Vorgänge mit Basiszugriff	15.000 API-Vorgänge pro Tag	RESOURCE_EXHAUSTED
Änderungsanträge	10.000 Vorgänge pro Anfrage	TOO_MANY_MUTATE_OPERATIONS
Planning Service-Anfragen	1 Abfragen pro Sekunde	RESOURCE_EXHAUSTED
Anfragen des Conversion-Upload-Dienstes	2.000 Conversions pro Anfrage	TOO_MANY_CONVERSIONS_IN_REQUEST
Anfragen an den Dienst „Abrechnung und Kontobudget“	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 APIs Operationen pro Entwickler-Token. API -Vorgänge entspricht der Summe der get-Anfragen und mutate-Vorgänge. Limits für tägliche API-Vorgänge hängt von der Zugriffsebene des Entwickler-Tokens ab. Die Im Leitfaden zu Zugriffsebenen und zulässiger Nutzung wird erläutert, API-Vorgangslimits für jede Zugriffsebene.

Anfragen, die gegen diese Limits verstoßen, werden mit folgender Fehlermeldung abgelehnt: RESOURCE_EXHAUSTED

gRPC-Einschränkungen

Alle Google Ads API-Clientbibliotheken verwenden gRPC zum Generieren von Anfragen und Antworten. Standardmäßig hat gRPC einen Nachrichtengröße von 4 MB, aber unsere Client-Bibliotheken setzen die maximale Nachrichtengröße auf 64 MB für mehr Effizienz.

Die Antworten dürfen dieses Limit nicht überschreiten. Beispiel: Eine Suchanfrage, enthält viele Felder, kann eine Antwort generieren, die größer als 64 MB ist. Bis Um diese Beschränkung zu vermeiden, können Sie die Anzahl der ausgewählten Felder reduzieren oder Streaming Für mutate-Vorgänge müssen weniger Vorgänge gesendet werden. pro Anfrage.

Anfragen, die gegen diese Beschränkung verstoßen, generieren kein GoogleAdsError, generiert jedoch einen 429 Resource Exhausted-gRPC-Fehler. Weitere Informationen finden Sie in der Liste der gRPC-Fehlercodes und Nachrichten.

Änderungsanträge

Zusätzlich zur Zählung auf das tägliche Vorgangskontingent des Nutzers hat ein "mutate"-Vorgang mit Anfrage darf nicht mehr als 10.000 Vorgänge pro Anfrage enthalten.

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

Zusätzliche Limits und Überlegungen für bestimmte Dienste und Anfragetypen sind die als Nächstes beschrieben werden.

Suchanfragen

Eine Search- oder SearchStream-Anfrage zählt als ein Vorgang für die Kontingent für tägliche Vorgänge. Eine SearchStream-Anfrage zählt als ein API-Vorgang. unabhängig von der Anzahl der Batches.

Anfragen in fortlaufender Sequenz

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

Weitere Informationen zur Paginierung finden Sie unter Durchblättern von Seiten Ergebnisse.

Andere Arten von Ersuchen

Eine Anfrage, die keine Get-, Mutate-, Search- oder SearchStream-Anfrage ist zählt als ein Vorgang auf das tägliche Vorgangskontingent des Nutzers.

Beispiele für solche Ersuchen:

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

Anfragen, die API-Ausnahmen zurückgeben

Anfragen, die mit einem GoogleAdsFailure werden noch auf die des täglichen Vorgangskontingents des Nutzers.

Anfragen, die fehlschlagen, aber keinen Fehler zurückgeben GoogleAdsFailure, z. B. aufgrund eines Fehlers am 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 Netzwerkverbindungsfehler.

Planungsdienste

Aufgrund von Kosten und Komplexität sind die folgenden Planungsservicemethoden unterliegen anderen Beschränkungen als bei anderen Arten von Anfragen.

• Begrenzt auf 1 Anfrage pro Sekunde und Kundennummer:

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

  Anfragen, die gegen diese Einschränkungen verstoßen, werden mit folgender Fehlermeldung abgelehnt: RESOURCE_EXHAUSTED

• 1 Abfragen pro Sekunde werden als 60 Anfragen pro 60 Sekunden berechnet.

• Auf 2 Anfragen pro Sekunde und Kundennummer begrenzt:

  • KeywordPlanIdeaService.GenerateAdGroupTheme

Beachten Sie diese Limits 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

• Auf 2.000 Anruf- oder Klick-Conversions pro Anfrage begrenzt:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

  Anfragen, die gegen diese Limits verstoßen, werden mit folgender Fehlermeldung abgelehnt: TOO_MANY_CONVERSIONS_IN_REQUEST

Uploaddienst für Conversion-Anpassungen

• Auf 2.000 Conversion-Anpassungen pro Anfrage begrenzt:

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

  Anfragen, die gegen diese Limits verstoßen, werden mit folgender Fehlermeldung abgelehnt: TOO_MANY_ADJUSTMENTS_IN_REQUEST

Abrechnungs- und Kontobudget-Dienste

• Ä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 folgenden Fehler abgelehnt: MUTATE_NOT_ALLOWED

• Für mutate-Anfragen 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 dem Ändern des Budgetauftrags und dem im selben Konto. Wenn Sie vor Ablauf von 12 Stunden Änderungen vornehmen, kann dies zu nicht behebbare Fehler, die nur von Ihrem Google Ads-Konto behoben werden können. .

Einladungen für Kundenkonten

Neue Nutzer können mit der CustomerUserAccessService Weil werden mit dieser Funktion Einladungs-E-Mails an andere Nutzer gesendet. missbraucht wird und somit sein Verhalten begrenzt:

• Nutzer können nur eine ausstehende Einladung für denselben Kunden erhalten Konto. Bei einer nachfolgenden Anfrage zum Senden einer Einladung an einen Nutzer für die bereits eine ausstehende Einladung vorhanden ist, wird dieser Fehler zurückgegeben: ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION

• In Kundenkonten können maximal 70 Einladungen gleichzeitig ausstehen. Wenn eine Anfrage gesendet wird, durch die dieser Wert überschritten wird, lautet dieser Fehler: zurückgegeben: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED

Nutzerdaten

Nutzerdaten werden über die UserDataService und die OfflineUserDataJobService In einem gegebenen UserData-Vorgang zum Erstellen oder Entfernen Satz von user_identifiers für einzelne Nutzende spezifisch sein.

Um dies zu erzwingen, OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS oder UserDataError.TOO_MANY_USER_IDENTIFIERS wird zurückgegeben, wenn mehr als 20 user_identifiers in einem UserData festgelegt.

Andere Arten von Limits

Ein wiederkehrendes Feld, z. B. eine Liste von Vorgängen, das zu viele Elemente in einem kann zu folgendem Fehler führen: REQUEST_SIZE_LIMIT_EXCEEDED Dieselbe Fehlermeldung kann auch auf andere Probleme zurückzuführen sein.

Wenn Sie auf diese Einschränkung stoßen und Anfragen senden, bei denen ein wiederholter sollten Sie die Anzahl der Elemente im wiederholten Feld reduzieren, indem Sie ein Liste der Vorgänge in einer mutate-Anfrage

Bei einer GAQL-Abfrage wird die maximale Anzahl von Elementen in einer IN-Klausel 20.000 ist. Wenn Sie diese Grenze überschreiten, FILTER_HAS_TOO_MANY_VALUES zurückgegeben.