Passer au contenu principal

​
Comment obtenir l’accès à l’API Ads

  1. Inscrivez-vous pour obtenir un compte développeur.
  2. Créez une App développeur et sécurisez votre jeton.
  3. Accédez à ads.x.com/help pour soumettre une demande d’accès à l’API Ads pour chacune de vos App(s) développeur.
Remarque : Si vous utilisez déjà la X Developer Platform et que vous avez un compte développeur, passez à l’étape trois.

​
Première étape : créer un compte développeur

Pour pouvoir envoyer des requêtes à n’importe quel produit d’API de X, vous devez d’abord créer un compte développeur. Dans la Console de développement, créez une App et une App développeur. Cela vous fournira un ensemble d’identifiants que vous utiliserez pour authentifier toutes vos requêtes auprès de l’API.

​
Étape deux : Enregistrez la clé et les jetons de votre App et gardez-les en sécurité

Dans votre App développeur, un ensemble de clés d’API (également appelées Consumer Keys) vous sera fourni. Vous aurez également la possibilité de générer un ensemble de jetons d’accès qui peuvent être utilisés pour envoyer des requêtes au nom de votre compte X personnel, ainsi qu’un Jeton Bearer qui peut être utilisé pour authentifier les points de terminaison qui nécessitent un Jeton Bearer OAuth 2.0. Comme ces clés et ces jetons n’expirent pas tant que vous ne les régénérez pas, nous vous suggérons de créer des variables d’environnement ou d’utiliser un gestionnaire de mots de passe sécurisé. Prenez également note de l’ID de votre App, que vous trouverez dans l’URL de la page de détails de votre App. Cela facilitera la demande d’accès à l’Ads API à l’étape suivante.
Remarque : Vos clés et jetons ne s’afficheront qu’une seule fois dans la Console de développement, il est donc important de stocker ces identifiants dans votre système de gestion de mots de passe dès que vous les générez.Si vous égarez ou oubliez les clés et jetons, vous devrez les régénérer, ce qui crée de nouvelles clés et de nouveaux jetons et invalide les anciens. Cela signifie que vous devrez mettre à jour toutes les intégrations que vous avez pu configurer avec vos identifiants précédents.En savoir plus sur nos bonnes pratiques d’authentification.

​
Troisième étape : demander l’accès à l’Ads API

À ce stade, vous aurez un accès de base à la X API, mais pas aux fonctionnalités spécifiques de la X Ads API. Ensuite, vous devrez demander l’accès et obtenir l’approbation pour l’Ads API. Rendez-vous sur ads.x.com/help pour soumettre une demande d’accès à l’Ads API pour chacune de vos App(s) de développeur.

​
Niveaux d’accès

Dans le cadre du processus de demande d’accès, vous devrez préciser le niveau d’accès requis. Pour en savoir plus, consultez la page sur les autorisations au niveau de l’App et du compte publicitaire.

​
Conversion uniquement

Accès aux endpoints de conversion mobile et web avec accès en lecture et en écriture.

​
Accès standard

Accès aux endpoints Analytics, Campaign Management, Creatives, Custom Audiences et Conversion avec des droits de lecture et d’écriture.
Remarque : Après l’approbation de votre App pour l’accès à l’Ads API, vous devrez régénérer tous les jetons d’accès utilisateur afin d’envoyer correctement des requêtes authentifiées à l’Ads API.
Remarque : Les développeurs Ads API qui ont demandé l’accès avant juillet 2023 peuvent disposer de niveaux d’accès et d’autorisations différents, et être limités à cinq jetons OAuth. Consultez notre guide sur l’extension de l’accès pour accéder à des endpoints supplémentaires ou lever les limites de jetons pour les applications existantes.

​
Effectuer votre première requête

Pour tester votre accès à l’Ads API, effectuez une requête vers le point de terminaison GET accounts. Ce point de terminaison renverra les comptes publicitaires auxquels l’utilisateur actuellement authentifié a accès. Utilisez les ad account IDs provenant de cette requête dans vos requêtes API ultérieures afin de lire et d’écrire des données pour un compte publicitaire donné. En utilisant Twurl en ligne de commande, la requête serait la suivante. Exemple de requête 
twurl -H ads-api.x.com "/11/accounts"
Exemple de réponse 
{
  "request": {
    "params": {}
  },
  "data": [
   {
    "name": "Furni",
    "business_name": null,
    "timezone": "America/Los_Angeles",
    "timezone_switch_at": "2016-04-06T07:00:00Z",
    "id": "18ce54ayf0z",
    "created_at": "2016-04-07T14:40:15Z",
    "salt": "b88939e5cabbca720159cb3659d73c06",
    "updated_at": "2017-02-08T08:49:53Z",
    "business_id": null,
    "approval_status": "ACCEPTED",
    "deleted": false
     }
   ]
}

​
Ensuite …