In der Search Ads 360 Reporting API gelten 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 im Gesamtpreis 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 über die Search- oder SearchStream-Methode ausgeführt werden.
- 3.000 Abfragen pro Minute,Projekt und Nutzer
- 3.000 Abfragen pro Minute und Projekt
- 150.000 Abfragen pro Tag und Projekt
Tägliche Limits für API-Vorgänge
Die täglichen API-Nutzungslimits basieren auf der Anzahl der API-Vorgänge, die pro Google Cloud-Projekt ausgeführt werden.
Eine einzelne Abfrage oder ein einzelner Bericht wird als ein Vorgang gezählt, unabhängig davon, welche Ergebnisse über SearchAds360Service.SearchStream gestreamt oder über einen SearchAds360Service.Search-Aufruf weitergeleitet 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 |
|---|---|
Betrieb: Search
Anzahl: 53 Anzeigengruppen
Dienst: |
1 |
Betrieb: SearchStream
Anzahl: 45 Kampagnen
Dienst: |
1 |
Anfragen, die gegen diese Limits verstoßen, werden mit der folgenden Fehlermeldung abgelehnt: RESOURCE_EXHAUSTED.
Suchanfragen
Eine Search- oder SearchStream-Anfrage zählt als ein Vorgang auf das tägliche Vorgangskontingent des Nutzers. Eine SearchStream-Anfrage zählt unabhängig von der Anzahl der Batches als ein API-Vorgang.
gRPC-Einschränkungen
Alle Clientbibliotheken der Search Ads 360 Reporting API verwenden gRPC zum Generieren von Anfragen und Antworten. Standardmäßig hat gRPC eine Nachrichtengröße von 4 MB.
Die Antworten dürfen dieses Limit nicht überschreiten. Beispielsweise kann eine Suchanfrage mit vielen Feldern eine Antwort generieren, die größer als 4 MB ist. Um dieses Limit zu vermeiden, können Sie die Anzahl der ausgewählten Felder reduzieren, die Seitengröße reduzieren oder Streaming verwenden.
Anfragen, die gegen diese Einschränkung verstoßen, generieren keinen SearchAds360Error, sondern einen 429 Resource Exhausted-gRPC-Fehler. Weitere Informationen finden Sie in der Liste der gRPC-Fehlercodes und -Nachrichten.
Anfragen in fortlaufender Sequenz
Anfragen in fortlaufender Sequenz (z. B. Anfragen mit einem gültigen next_page_token) werden nicht auf das tägliche Vorgangskontingent eines Nutzers angerechnet.
Paginierungsanfragen, die ein abgelaufenes oder ungültiges Seitentoken enthalten, erzeugen jedoch eine Ausnahme und werden auf das tägliche Vorgangskontingent angerechnet.
Anfragen, die paginiert werden, z. B. Suchanfragen, unterliegen ebenfalls der Einschränkung Page size cannot exceed 10,000 rows und werden abgelehnt, wenn sie gegen dieses Limit verstoßen. Dabei wird folgender Fehler zurückgegeben: INVALID_PAGE_SIZE.
Weitere Informationen zur Paginierung finden Sie unter Ergebnisse durchgehen.
Anfragen, die API-Ausnahmen zurückgeben
Anfragen, die mit einem SearchAds360Failure abgelehnt werden, werden dennoch auf das tägliche Vorgangskontingent des Nutzers angerechnet.
Anfragen, die fehlschlagen, aber kein 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 würden. Ein Beispiel hierfür ist ein Ausfall der Netzwerkverbindung.
Andere Arten von Limits
Für ein wiederkehrendes Feld wie eine Liste von Vorgängen, das zu viele Elemente in einer Anfrage enthält, kann der folgende Fehler auftreten: REQUEST_SIZE_LIMIT_EXCEEDED.
Dieselbe Fehlermeldung kann auch auf andere Probleme zurückzuführen sein.
Bei einer Abfrage in der Search Ads 360 Query Language (Abfragesprache) beträgt die maximale Anzahl von Elementen in einer IN-Klausel 20.000. Wird dieses Limit überschritten, wird der Fehler FILTER_HAS_TOO_MANY_VALUES zurückgegeben.