Diese Seite wurde von der Cloud Translation API übersetzt.

API-Limits und Kontingente

Bei der Google Ads API gelten bestimmte Einschränkungen für API-Vorgänge, beispielsweise die Anzahl der Vorgänge, die in einer einzelnen Änderungsanfrage gesendet werden können. In der folgenden Tabelle sind einige der wichtigen Limits und Kontingente zusammengefasst, die Sie beachten sollten.

Anfragetyp, Einschränkung und Fehlercode
Anfragen mit nummerierten Seiten	10.000 Zeilen pro Seite	`INVALID_PAGE_SIZE`
Vorgänge mit einfachem Zugriff	15.000 API-Vorgänge pro Tag	`RESOURCE_EXHAUSTED`
Änderungsanfragen	10.000 Vorgänge pro Anfrage	`TOO_MANY_MUTATE_OPERATIONS`
Anfragen für den Planungsdienst	1 Abfragen pro Sekunde	`RESOURCE_EXHAUSTED`
Anfragen für den Conversion-Upload-Dienst	2.000 Conversions pro Anfrage	`TOO_MANY_CONVERSIONS_IN_REQUEST`
Anfragen zum Abrechnungs- und Kontobudgetdienst	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 API-Vorgänge, die pro Entwicklertoken vorgenommen wurden. API-Vorgänge sind die Gesamtsumme der Abruf- und mutate-Vorgänge. Die Limits für die täglichen API-Vorgänge hängen von der Zugriffsebene des Entwicklertokens ab. Im Leitfaden zu Zugriffsebenen und zulässiger Nutzung werden die spezifischen API-Vorgangslimits für die einzelnen Zugriffsebenen beschrieben.

Anfragen, die gegen diese Limits verstoßen, werden mit dem Fehler RESOURCE_EXHAUSTED abgelehnt.

gRPC-Einschränkungen

Alle Google Ads API-Clientbibliotheken verwenden gRPC, um Anfragen und Antworten zu generieren. Standardmäßig hat gRPC eine Nachrichtengröße von 4 MB. Unsere Clientbibliotheken legen jedoch die maximale Nachrichtengröße auf 64 MB fest, um die Effizienz zu erhöhen.

Dieses Limit darf für Antworten nicht überschritten werden. Beispielsweise kann eine Suchanfrage, die viele Felder enthält, eine Antwort generieren, die größer als 64 MB ist. Um dieses Limit zu vermeiden, können Sie die Anzahl der ausgewählten Felder oder die Seitengröße reduzieren oder Streaming verwenden. Bei mutate-Vorgängen müssen weniger Vorgänge pro Anfrage gesendet werden.

Anfragen, die gegen diese Einschränkung verstoßen, generieren keinen GoogleAdsError, sondern einen 429 Resource Exhausted-gRPC-Fehler. Sehen Sie sich dazu die Liste der gRPC-Fehlercodes und -Nachrichten an.

Änderungsanfragen

Abgesehen von der Berücksichtigung des täglichen Vorgangskontingents des Nutzers darf eine mutate-Anfrage nicht mehr als 10.000 Vorgänge pro Anfrage enthalten.

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

Zusätzliche Limits und Überlegungen für bestimmte Dienste und Anfragetypen finden Sie im Folgenden.

Suchanfragen

Eine Search- oder SearchStream-Anfrage zählt als ein Vorgang auf Basis des täglichen Vorgangskontingents des Nutzers. Eine SearchStream-Anfrage zählt unabhängig von der Anzahl der Batches als ein API-Vorgang.

Anfragen mit nummerierten Seiten

Anfragen mit Seitenumbruch (z. B. Anfragen, die ein gültiges next_page_token enthalten) werden nicht auf das tägliche Vorgangskontingent eines Nutzers angerechnet. Paginierungsanfragen, die ein abgelaufenes oder ungültiges Seitentoken enthalten, lösen jedoch eine Ausnahme aus und werden auf das tägliche Kontingent für Vorgänge angerechnet.

Anfragen in mehreren Seiten, z. B. Suchanfragen, unterliegen ebenfalls der Beschränkung Page size cannot exceed 10,000 rows und werden mit dem Fehler INVALID_PAGE_SIZE abgelehnt, wenn sie gegen dieses Limit verstoßen.

Weitere Informationen zur Paginierung finden Sie unter In Ergebnissen suchen.

Andere Arten von Ersuchen

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

Beispiele für solche Anfragen:

Anfragen, die API-Ausnahmen zurückgeben

Mit GoogleAdsFailure abgelehnte Anfragen werden weiterhin auf das tägliche Vorgangskontingent des Nutzers angerechnet.

Anfragen, die fehlschlagen, aber keinen GoogleAdsFailure zurückgeben, z. B. aufgrund eines Fehlers auf Netzwerkebene, werden nicht auf das tägliche Vorgangskontingent des Nutzers angerechnet, da die Anfragen den Dienst nie erreichen. Ein Beispiel hierfür ist ein Ausfall der Netzwerkverbindung.

Planungsdienste

Aufgrund der Kosten und der Komplexität gelten für die unten aufgeführten Planungsdienstmethoden andere Einschränkungen als für andere Anfragetypen.

Beschränkt auf 1 Anfrage pro Sekunde und Kundennummer oder Entwicklertoken:
Anfragen, die gegen diese Einschränkungen verstoßen, werden mit dem Fehler RESOURCE_EXHAUSTED abgelehnt.
1 Abfragen pro Sekunde werden als 60 Anfragen pro 60 Sekunden berechnet.

Berücksichtigen Sie diese Beschränkungen beim Erstellen eines Keyword-Plans.

Keyword-Planobjekt	Maximale Anzahl
`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

Beschränkt auf 2.000 Anruf- oder Klick-Conversions pro Anfrage:
- ConversionUploadService.UploadCallConversions
- ConversionUploadService.UploadClickConversions
Anfragen, die gegen diese Limits verstoßen, werden mit dem Fehler TOO_MANY_CONVERSIONS_IN_REQUEST abgelehnt.

Uploaddienst für Conversion-Anpassungen

Beschränkt auf 2.000 Conversion-Anpassungen pro Anfrage:
- ConversionAdjustmentUploadService.UploadConversionAdjustments
Anfragen, die gegen diese Limits verstoßen, werden mit dem Fehler TOO_MANY_ADJUSTMENTS_IN_REQUEST abgelehnt.

Abrechnung und Kontobudgetdienste

Änderungen sind nur für Konten möglich, für die die monatliche Rechnungsstellung konfiguriert ist.

Anfragen, die gegen diese Einschränkung verstoßen, werden mit dem Fehler MUTATE_NOT_ALLOWED abgelehnt.
Für Änderungsanfragen ist nur 1 Vorgang zulässig.

Anfragen, die gegen diese Einschränkung verstoßen, werden mit dem Fehler TOO_MANY_MUTATE_OPERATIONS abgelehnt.
Sie sollten mindestens 12 Stunden zwischen Budgetauftragsänderungen für dasselbe Konto warten. Wenn Sie Änderungen vornehmen, bevor 12 Stunden vergangen sind, können Fehler auftreten, die nur von Ihrem Google Ads-Kundenbetreuer behoben werden können.

Einladungen für Kundenkonten

Neue Nutzer können mit der CustomerUserAccessService in bestehende Kundenkonten eingeladen werden. Da diese Funktion Einladungs-E-Mails an andere Nutzer sendet, kann sie missbraucht werden. Daher gibt es Einschränkungen für ihr Verhalten:

Nutzer können nicht mehr als eine ausstehende Einladung für dasselbe Kundenkonto erhalten. Wird später eine Einladung an einen Nutzer gesendet, der bereits eine ausstehende Einladung hat, wird dieser Fehler zurückgegeben: ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.
Für Kundenkonten dürfen nicht mehr als 70 Einladungen gleichzeitig ausstehen. Wenn eine Anfrage gesendet wird, die dazu führt, dass dieser Wert überschritten wird, wird dieser Fehler zurückgegeben: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.

Nutzerdaten

Nutzerdaten werden mit dem UserDataService und dem OfflineUserDataJobService verwaltet. Beim Erstellen/Entfernen von UserData sollte jeder Satz von user_identifiers für einen einzelnen Nutzer spezifisch sein.

Um dies zu erzwingen, wird der Fehler OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS oder UserDataError.TOO_MANY_USER_IDENTIFIERS zurückgegeben, wenn mehr als 20 user_identifiers in einem UserData-Satz enthalten sind.

Andere Arten von Limits

Ein wiederkehrendes Feld wie eine Liste von Vorgängen, das zu viele Elemente in einer Anfrage enthält, 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 stellen, die ein wiederkehrendes Feld verwenden, versuchen Sie, die Anzahl der Elemente im wiederholten Feld zu reduzieren. Stellen Sie dazu eine Liste mit Vorgängen in einer mutate-Anfrage bereit.

Bei einer GAQL-Abfrage darf eine IN-Klausel maximal 20.000 Elemente enthalten. Wird das Limit überschritten, wird der Fehler FILTER_HAS_TOO_MANY_VALUES zurückgegeben.