Passer au contenu principal

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

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

​
Première étape : Inscrivez-vous pour obtenir un compte développeur

Pour effectuer une requête vers n’importe quel produit de l’API de X, vous devez d’abord vous inscrire pour obtenir un compte développeur. Dans le developer portal, créez un Project et une App développeur. Vous obtiendrez ainsi un ensemble d’identifiants que vous utiliserez pour authentifier toutes les requêtes adressées à l’API.

​
Deuxième étape : Enregistrez les clés et jetons de votre App et gardez-les en sécurité

Dans votre App développeur, un ensemble d’API Key (également appelées Consumer Key) vous sera fourni. Vous aurez également la possibilité de générer un ensemble d’Access Tokens pouvant être utilisés pour effectuer des requêtes au nom de votre compte X personnel, ainsi qu’un Jeton Bearer pouvant être utilisé pour authentifier des endpoints nécessitant OAuth 2.0 Bearer Token. Comme ces clés et jetons n’expirent pas sauf en cas de régénération, nous vous suggérons de créer des variables d’environnement ou d’utiliser un gestionnaire de mots de passe sécurisé. Veuillez également noter votre App ID, que vous pouvez trouver dans l’URL des détails de votre App. Cela facilitera la demande d’accès à la X Ads API à l’étape suivante.
Remarque : Vos clés et jetons ne s’affichent qu’une seule fois dans le developer portal ; il est donc important de stocker ces informations d’identification dans votre gestionnaire de mots de passe dès leur génération.Si vous égarez ou oubliez les clés et jetons, vous devrez les régénérer, ce qui créera de nouvelles clés et de nouveaux jetons et invalidera les anciens. Cela signifie que vous devrez mettre à jour toute intégration que vous avez configurée avec vos informations d’identification précédentes.En savoir plus sur nos meilleures pratiques d’authentification.

​
Troisième étape : demander l’accès à la X 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. Vous devrez ensuite demander l’accès et obtenir l’approbation pour la X Ads API. Rendez-vous sur ads.x.com/help pour soumettre une demande d’accès à la X Ads API pour chacune de vos App développeur.

​
Niveaux d’accès

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

​
Conversion uniquement

Accès aux endpoints de conversion mobile et web avec droits de lecture et d’écriture.

​
Accès standard

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

​
Effectuez votre première requête

Pour tester votre accès à la X Ads API, envoyez une requête à l’endpoint GET accounts. Cet endpoint renvoie les comptes publicitaires auxquels l’utilisateur actuellement autorisé a accès. Utilisez les id de compte publicitaire issus de cette requête dans les requêtes API suivantes pour lire et écrire des data pour un compte publicitaire spécifique. 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
     }
   ]
}

​
Et ensuite…

⌘I