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.
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:
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:
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:
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.