Die Search Ads 360 Reporting API erzwingt Einschränkungen 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 Gesamtpreis von Search Ads 360 inbegriffen. Für die Verwendung 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 und Projekt pro Nutzer
- 3.000 Abfragen pro Minute und Projekt
- 150.000 Abfragen pro Tag und Projekt
Tageslimits für API-Vorgänge
Die täglichen Limits für die 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 geblättert 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: |
1 |
Vorgang: SearchStream
Anzahl: 45 Kampagnen
Dienst: |
1 |
Anfragen, die gegen diese Limits verstoßen, werden mit dem Fehler RESOURCE_EXHAUSTED abgelehnt.
Suchanfragen
Eine Search- oder SearchStream-Anfrage wird dem täglichen Vorgangskontingent des Nutzers als ein Vorgang angerechnet. 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.
Antworten dürfen dieses Limit nicht überschreiten. Eine Suchanfrage mit vielen Feldern kann beispielsweise eine Antwort mit einer Größe von mehr als 4 MB generieren. Sie können dieses Limit vermeiden, indem Sie die Anzahl der ausgewählten Felder reduzieren, die Seitengröße verkleinern oder Streaming verwenden.
Bei Anfragen, die gegen diese Einschränkung verstoßen, wird kein SearchAds360Error, sondern ein 429 Resource Exhausted-gRPC-Fehler generiert. Weitere Informationen finden Sie in der Liste der gRPC-Fehlercodes und ‑meldungen.
Paginierte Anfragen
Paginierte Anfragen (z. B. Anfragen, die eine gültige next_page_token enthalten) werden nicht auf das tägliche Betriebskontingent eines Nutzers angerechnet.
Paginierungsanfragen mit einem abgelaufenen oder ungültigen Seiten-Token führen jedoch zu einer Ausnahme und werden auf das tägliche Betriebskontingent angerechnet.
Anfragen, die paginated sind, z. B. Suchanfragen, unterliegen ebenfalls der Einschränkung von Page size cannot exceed 10,000 rows und werden abgelehnt, wenn sie gegen dieses Limit verstoßen. In diesem Fall wird der Fehler INVALID_PAGE_SIZE ausgegeben.
Weitere Informationen zur Paginierung finden Sie unter In Ergebnissen suchen.
Anfragen, die API-Ausnahmen zurückgeben
Anfragen, die mit SearchAds360Failure abgelehnt werden, werden auf das Tageskontingent des Nutzers angerechnet.
Anfragen, die fehlschlagen, aber keine SearchAds360Failure zurückgeben, z. B. aufgrund eines Fehlers auf Netzwerkebene, werden nicht auf das tägliche Betriebskontingent des Nutzers angerechnet, da die Anfragen den Dienst nie erreichen. Ein Beispiel hierfür ist ein Ausfall der Netzwerkverbindung.
Andere Arten von Limits
Wenn ein wiederkehrendes Feld, z. B. eine Liste von Vorgängen, zu viele Elemente in einer Anfrage enthält, kann der Fehler REQUEST_SIZE_LIMIT_EXCEEDED auftreten.
Diese Fehlermeldung kann auch andere Ursachen haben.
Bei einer Search Ads 360-Abfragesprache darf eine IN-Klausel maximal 20.000 Elemente enthalten. Wird dieses Limit überschritten, wird der Fehler FILTER_HAS_TOO_MANY_VALUES zurückgegeben.