Rate Limits

Die Advertiser API unterliegt ähnlich wie die REST API v1.1 Rate Limits, wie hier dokumentiert: REST API Rate Limiting in v1.1. Anders als bei der REST API v1.1 gibt es jedoch keinen programmatischen Index der Limits pro endpoint. Die Rate Limits und Reset-Fenster pro endpoint werden über HTTP-Antwortheader mitgeteilt. Alle Rate Limits in der Ads API verwenden OAuth 1.0a.

​

Limits auf Nutzerebene und Werbekontoebene

Es gibt zwei Arten von Rate Limits: auf Nutzertoken-Ebene und auf Werbekontoebene. Ein Teil der Endpoints ist für die Verwendung von Rate Limits auf Werbekontoebene aktiviert. Ein Nutzertoken ist der OAuth access token, den Sie zur Authentifizierung und für Aufrufe der Ads API verwenden. Jedes Nutzertoken kann Zugriff auf ein oder mehrere Werbekonten haben.

Entwickler sollten das Rate Limit auf Werbekontoebene verwenden, wenn es in den Response-Headern zurückgegeben wird, und nur das Limit auf Nutzerebene nutzen, wenn kein Limit auf Werbekontoebene vorhanden ist.

Rate Limits auf Nutzerebene werden über diese Header angegeben: x-rate-limit-limit, x-rate-limit-remaining und x-rate-limit-reset.

Für Endpoints mit aktiviertem Rate Limiting auf Werbekontoebene werden die Rate Limits über diese Header angegeben: x-account-rate-limit-limit, x-account-rate-limit-remaining und x-account-rate-limit-reset.

Die Rate Limits auf Werbekontoebene werden nur für GET-Endpoints bereitgestellt, um Anwendungen zu ermöglichen, Entitätsdaten (wie Kampagnen- oder Line-Item-Objekte) mit einem einzelnen Nutzertoken über mehrere Werbekonten hinweg zu synchronisieren. Schreibaktionen verwenden nicht zwingend dieselben Rate Limits auf Werbekontoebene.

Für Endpoints mit Rate Limits auf Werbekontoebene ist das Rate Limit auf Nutzerebene auf einen hohen Wert gesetzt, der ein globales Kontingent für Ihre gesamte Anwendung darstellt. Wenn verfügbar, sollte das Rate Limit auf Werbekontoebene bei der Steuerung Ihres Anfragevolumens Vorrang haben.

​

Best Practices

1. Speichern Sie in Ihrer Datenbank einen Zeitstempel des zuletzt synchronisierten Stands und fordern Sie, wo möglich, bei Datenabrufen die Daten mit der Option sort_by=updated_at-desc an. So können Sie den Synchronisierungsvorgang beenden, sobald Sie auf Daten stoßen, die älter sind als Ihr zuletzt synchronisierter Zeitstempel. Dadurch vermeiden Sie redundante Synchronisierungen derselben Daten.

2. Fordern Sie mehrere Entitäten in einer einzelnen Anfrage an: Einige Endpoints erlauben eine kommagetrennte Liste von Werten, um mehrere ähnliche Datensätze abzurufen. Das verringert die Gesamtzahl Ihrer Aufrufe und nutzt die Rate Limit effizienter.

3. Fordern Sie den maximalen „count“ in Ihren Anfragen an: Einige Endpoints wie GET accounts/:account_id/targeting_criteria sollten nachdrücklich mit dem maximalen count-Wert aufgerufen werden, um 1000 Objekte statt des Standardwerts von 200 zurückzugeben.

​

Synchronisierung von Analytics

Weitere Informationen zu Rate Limits für Analytics-endpoints finden Sie im Analytics Rate Limiting Guide.

​

FAQs

Ist es möglich, die Rate Limits für ein bestimmtes Werbekonto oder unsere App zu erhöhen?

Wir können die Rate Limits in der Regel nicht erhöhen; sie sind so festgelegt, dass sie auch die größten Werbekonten unterstützen. Bitte setzen Sie zunächst die in diesem Dokument aufgeführten Best Practices um. Sollten die Rate Limits weiterhin Ihre Skalierung oder das Erreichen Ihrer Geschäftsziele beeinträchtigen, wenden Sie sich mit vollständigen Details zum Use Case und den betreffenden Requests an Ihre X Ads API‑Kontakte.

​

Geltungsbereiche der Rate Limits

​

Geltungsbereiche für dieses Dokument

• Kategorie: Alle endpoints, die in die angegebene Kategorie fallen, unterliegen einer Rate Limit mit einem einzigen zugewiesenen Limit pro Zeitfenster.
• Endpoint: Jeder endpoint hat sein eigenes, separates zugewiesenes Limit pro Zeitfenster.

​

Ads API Rate-Limit-Übersicht

​

Ads API Rate Limits

Endpoint-Typ	Geltungsbereich nach Endpoint oder Kategorie	Rate Limit pro 1‑Minuten‑Fenster
Writes (POST, PUT, DELETE)	Kategorie	450
Audience	Endpoint	1500

Endpoint-Typ	Geltungsbereich nach Endpoint oder Kategorie	Rate Limit pro 15‑Minuten‑Fenster
Analytics (synchron)	Kategorie	250
Core Entity Reads (Line Items, Campaigns, etc.) Other Account Reads (Other GET endpoints with :account_id)	Endpoint (Ad‑Account‑Ebene) Endpoint (teilweise Ad‑Account‑Ebene)	10,000 2000
Targeting Criteria (außer unten)	Kategorie	400
Targeting Criteria (tv_markets, tv_shows)	Endpoint	2000
Audience Insights	Kategorie	400
Keyword Insights	Kategorie	500
Global Reads (GET endpoints without :account_id)	Endpoint	5
Conversions	Endpoint	60,000