Die Search Ads 360 Reporting API erzwingt Limits für API-Vorgänge, um eine optimale Systemleistung für alle Nutzer zu gewährleisten.
Preise
Die Nutzung der Search Ads 360 Reporting API ist in den Gesamtpreisen von Search Ads 360 enthalten. Für die Nutzung der API fallen keine zusätzlichen Gebühren an.
Abfragelimits
Die folgenden Limits gelten für Abfragevorgänge, die mit den Methoden „Search“ oder „SearchStream“ ausgeführt werden.
- 3.000 Abfragen pro Minute und Projekt pro Nutzer
- 3.000 Abfragen pro Minute und Projekt
- 150.000 Abfragen pro Tag und Projekt
Limits für tägliche API-Vorgänge
Die Limits für die tägliche API-Nutzung basieren auf der Anzahl der API-Vorgänge pro Google Cloud-Projekt.
Eine einzelne Abfrage oder ein einzelner Bericht wird als ein Vorgang gezählt, unabhängig davon, ob die Ergebnisse
über
SearchAds360Service.SearchStream
gestreamt oder über einen
SearchAds360Service.Search
-Aufruf seitenweise abgerufen werden. Weitere Informationen.
In der folgenden Tabelle sehen Sie einige Beispiele, wie verschiedene Vorgänge gezählt werden:
| API-Anfrage | Auf das Tageslimit angerechnete Vorgänge |
|---|---|
Vorgang: Search
Anzahl: 53 Anzeigengruppen Dienst: SearchAds360Service
|
1 |
Vorgang: SearchStream
Anzahl: 45 Kampagnen Dienst: SearchAds360Service
|
1 |
Anfragen, die gegen diese Limits verstoßen, werden mit dem Fehler:
RESOURCE_EXHAUSTED abgelehnt.
Suchanfragen
Eine Search oder SearchStream Anfrage wird auf das tägliche Vorgangskontingent des Nutzers angerechnet. Eine SearchStream-Anfrage wird unabhängig von der Anzahl der Batches als ein API-Vorgang gezählt.
gRPC-Einschränkungen
Alle Clientbibliotheken der Search Ads 360 Reporting API verwenden gRPC zum Generieren von Anfragen und Antworten. Standardmäßig ist die Nachrichtengröße von gRPC auf 4 MB festgelegt.
Antworten dürfen dieses Limit nicht überschreiten. Eine Suchanfrage, die viele Felder enthält, kann beispielsweise eine Antwort erzeugen, die größer als 4 MB ist. Um dieses Limit zu vermeiden, können Sie die Anzahl der ausgewählten Felder oder die Seiten größe reduzieren oder Streaming verwenden.
Bei Anfragen, die gegen diese Einschränkung verstoßen, wird kein
SearchAds360Error,
sondern ein 429 Resource Exhausted gRPC-Fehler generiert. Eine Liste der gRPC-Fehlercodes und -Meldungen finden Sie hier.
Seitenweise Anfragen
Seitenweise Anfragen (z. B. Anfragen, die ein gültiges next_page_token enthalten) werden nicht auf das tägliche Vorgangskontingent eines Nutzers angerechnet.
Bei Seitenanfragen, die ein abgelaufenes oder ungültiges Seiten-Token enthalten, wird jedoch eine Ausnahme generiert und sie werden auf das tägliche Vorgangskontingent angerechnet.
Für Anfragen, die seitenweise abgerufen werden, z. B. Suchanfragen, gilt auch das
Page size cannot exceed 10,000 rows Limit. Wenn dieses Limit überschritten wird, werden sie mit dem Fehler
INVALID_PAGE_SIZE abgelehnt.
Weitere Informationen zum seitenweisen Abrufen von Ergebnissen finden Sie unter Ergebnisse seitenweise abrufen.
Anfragen, die API-Ausnahmen zurückgeben
Anfragen, die mit einem
SearchAds360Failure
abgelehnt werden, werden weiterhin auf das tägliche Vorgangskontingent des Nutzers angerechnet.
Anfragen, die fehlschlagen, aber keinen
SearchAds360Failure 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 Fehler bei der Netzwerkverbindung.
Weitere Arten von Limits
Ein wiederholtes Feld, z. B. eine Liste von Vorgängen, das in einer
Anfrage zu viele Elemente enthält, kann den Fehler:
REQUEST_SIZE_LIMIT_EXCEEDED verursachen.
Diese Fehlermeldung kann auch auf andere Probleme zurückzuführen sein.
Bei einer Search Ads 360 Query Language-Abfrage
beträgt die maximale Anzahl von Elementen in einer IN-Klausel 20.000. Wenn Sie dieses
Limit überschreiten, wird der
FILTER_HAS_TOO_MANY_VALUES
Fehler zurückgegeben.