Limitation de taux

L’API Ads est soumise à des limites de taux similaires à celles de l’API REST v1.1, comme indiqué ici : REST API Rate Limiting in v1.1. Contrairement à l’API REST v1.1, il n’existe pas d’index programmatique des limites par endpoint. Les limites de taux par endpoint et leurs fenêtres de réinitialisation sont communiquées via les en-têtes de réponse HTTP. Tous les mécanismes de limitation de taux de l’API Ads utilisent OAuth 1.0a.

​

Limites au niveau de l’utilisateur et au niveau du compte publicitaire

Il existe deux types de limites de taux : au niveau du jeton utilisateur et au niveau du compte publicitaire. Un sous-ensemble d’endpoints prend en charge les limites de taux au niveau du compte publicitaire. Un jeton utilisateur est le jeton d’accès OAuth que vous utilisez pour vous authentifier et appeler l’Ads API. Chaque jeton utilisateur peut avoir accès à un ou plusieurs comptes publicitaires.

Les développeurs doivent utiliser la limite de taux au niveau du compte publicitaire lorsqu’elle est renvoyée dans les en-têtes de réponse, et n’utiliser la limite au niveau de l’utilisateur que lorsque la limite du compte publicitaire n’est pas disponible.

Les limites de taux au niveau de l’utilisateur sont exprimées via ces en-têtes : x-rate-limit-limit, x-rate-limit-remaining et x-rate-limit-reset.

Pour les endpoints avec limites de taux au niveau du compte publicitaire activées, les limites de taux sont exprimées via ces en-têtes : x-account-rate-limit-limit, x-account-rate-limit-remaining et x-account-rate-limit-reset.

Les limites de taux au niveau du compte publicitaire sont fournies uniquement pour les endpoints GET afin de permettre aux applications de synchroniser les données d’entités (telles que les objets de campagne ou d’élément de campagne) à partir d’un seul jeton utilisateur accédant à plusieurs comptes publicitaires. Les actions d’écriture ne sont pas garanties d’utiliser les mêmes limites de taux au niveau du compte publicitaire.

Pour les endpoints soumis à des limites de taux au niveau du compte publicitaire, la limite de taux au niveau de l’utilisateur est définie à une valeur élevée représentant un quota global pour l’ensemble de votre application. Lorsqu’elle est disponible, la limite de taux au niveau du compte publicitaire doit prévaloir pour contrôler votre volume de requêtes.

​

Bonnes pratiques

1. Enregistrez dans votre base de données un horodatage correspondant à la dernière synchronisation et, lors de la récupération des données, lorsque c’est possible, récupérez-les avec l’option sort_by=updated_at-desc afin de pouvoir arrêter votre processus de synchronisation dès que vous atteignez des données plus anciennes que votre dernier horodatage de synchronisation. Cela évitera de synchroniser plusieurs fois les mêmes données.

2. Récupérez plusieurs entités dans une seule requête : certains endpoints vous permettent de spécifier une liste de valeurs séparées par des virgules pour récupérer plusieurs éléments de données similaires. Cela peut réduire le nombre total d’appels que vous effectuez et vous permettre d’exploiter plus efficacement la limite de requêtes.

3. Utilisez la valeur maximale de « count » dans vos requêtes : certains endpoints, comme GET accounts/:account_id/targeting_criteria, sont fortement recommandés avec la valeur maximale de count afin de renvoyer 1000 objets au lieu de la valeur par défaut de 200.

​

Synchronisation d’Analytics

Consultez le guide sur les limites de taux pour Analytics pour plus d’informations sur les limites de taux des endpoints Analytics.

​

FAQ

Est-il possible d’augmenter les limites de taux pour un compte publicitaire particulier ou pour notre application ?

Nous ne pouvons en général pas augmenter les limites de taux, qui sont définies de manière à prendre en charge les plus grands comptes publicitaires. Veuillez commencer par mettre en œuvre les bonnes pratiques décrites dans ce document et, si les limites de taux continuent d’affecter votre capacité à passer à l’échelle ou à atteindre vos objectifs commerciaux, contactez vos interlocuteurs X Ads API en leur fournissant tous les détails sur le cas d’utilisation et les requêtes concernées.

​

Portées de la limitation de débit

​

Portées pour ce document

• Catégorie : tous les endpoints qui relèvent de la catégorie donnée partagent une seule limite de débit allouée par fenêtre.
• Endpoint : chaque endpoint dispose de sa propre limite de débit allouée par fenêtre.

​

Tableau des limites de débit de l’API Ads

​

Limites de taux de l’API Ads

Type d’endpoint	Portée par endpoint ou catégorie	Limite de taux par fenêtre de 1 minute
Écritures (POST, PUT, DELETE)	Catégorie	450
Audience	Endpoint	1500

Type d’endpoint	Portée par endpoint ou catégorie	Limite de taux par fenêtre de 15 minutes
Analytics (synchrones)	Catégorie	250
Lectures d’entités principales (Line Items, Campaigns, etc.) Autres lectures de compte (autres endpoints GET avec :account_id)	Endpoint (niveau du compte publicitaire) Endpoint (niveau partiel du compte publicitaire)	10,000 2000
Critères de ciblage (autres que ci‑dessous)	Catégorie	400
Critères de ciblage (tv_markets, tv_shows)	Endpoint	2000
Audience Insights	Catégorie	400
Keyword Insights	Catégorie	500
Lectures globales (endpoints GET sans :account_id)	Endpoint	5
Conversions	Endpoint	60,000