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 einzigen mutate-Anfrage gesendet werden können. In der folgenden Tabelle sind einige und Kontingente, die Sie kennen müssen.

Warnung: Get-Methoden werden nicht mehr unterstützt. Verwenden Sie searchStream oder search, um Objekte abzurufen.

Anfragetyp, Einschränkung und Fehlercode
Anfragen in fortlaufender Sequenz	10.000 Zeilen pro Seite	INVALID_PAGE_SIZE
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 diese Grenze 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, die Seite verkleinern oder verwenden Sie Streaming. Für mutate-Anfragen müssen Sie weniger senden. Vorgänge 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 wie unten beschrieben.

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.

Aufeinanderfolgende Anfragen, wie z. B. Suchanfragen, unterliegen ebenfalls den Page size cannot exceed 10,000 rows Einschränkung und werden abgelehnt, wenn sie gegen die Einschränkung verstoßen mit folgendem Fehler: INVALID_PAGE_SIZE.

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 nachfolgend aufgeführten Methoden für den Planungsservice: 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-Upload-Dienst

• 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 mit dieser Funktion Einladungs-E-Mails an andere Nutzer gesendet werden, 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 das UserDataService und die OfflineUserDataJobService. Bei einem gegebenen UserData-Vorgang zum Erstellen/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.