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