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:

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.

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

Uploaddienst für Conversion-Anpassungen

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:

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.