> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide étape par étape

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

<div id="how-to-get-access-to-the-ads-api">
  ## Comment obtenir l’accès à l’API Ads
</div>

1. Inscrivez-vous pour obtenir un [compte développeur](https://developer.x.com/en/apply-for-access).
2. Créez une [App développeur](https://developer.x.com/app) et sécurisez votre jeton.
3. Accédez à [ads.x.com/help](https://ads.x.com/help) pour soumettre une demande d’accès à l’API Ads pour chacune de vos App(s) développeur.

<Note>**Remarque :** Si vous utilisez déjà la X Developer Platform et que vous avez un compte développeur, passez à l’étape trois.</Note>

<div id="step-one-signup-for-a-developer-account">
  ### Première étape : créer un compte développeur
</div>

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.

<Button href="https://developer.x.com/en/apply-for-access">
  Créer un compte développeur
</Button>

<div id="step-two-save-your-apps-key-and-tokens-and-keep-them-secure">
  ### Étape deux : Enregistrez la clé et les jetons de votre App et gardez-les en sécurité
</div>

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.

<Note>
  **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](https://developer.x.com/en/docs/authentication/guides/authentication-best-practices).
</Note>

<div id="step-three-apply-for-access-to-the-ads-api">
  ### Troisième étape : demander l’accès à l’Ads API
</div>

À ce stade, vous aurez [un accès de base à la X API](https://developer.x.com/en/docs/twitter-api/v1), 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](https://ads.x.com/help) pour soumettre une demande d’accès à l’Ads API pour chacune de vos App(s) de développeur.

<div id="access-tiers">
  ### Niveaux d’accès
</div>

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](https://developer.x.com/en/docs/twitter-ads-api/obtaining-ads-account-access#levels-of-access).

<div id="conversion-only">
  #### Conversion uniquement
</div>

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

<div id="standard-access">
  #### Accès standard
</div>

Accès aux endpoints Analytics, Campaign Management, Creatives, Custom Audiences et Conversion avec des droits de lecture et d’écriture.

<Note>**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](https://developer.x.com/resources/fundamentals/authentication/obtaining-user-access-tokens) afin d’envoyer correctement des [requêtes authentifiées à l’Ads API](https://developer.x.com/en/docs/twitter-ads-api/making-authenticated-requests).</Note>

<Note>**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](https://developer.x.com/en/docs/twitter-ads-api/increasing-access) pour accéder à des endpoints supplémentaires ou lever les limites de jetons pour les applications existantes.</Note>

<div id="make-your-first-request">
  ## Effectuer votre première requête
</div>

Pour tester votre accès à l’Ads API, effectuez une requête vers le point de terminaison [GET accounts](https://developer.x.com/en/docs/twitter-ads-api/campaign-management/api-reference/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](https://developer.x.com/en/docs/tutorials/using-twurl) en ligne de commande, la requête serait la suivante.

**Exemple de requête**

```bash theme={null}
twurl -H ads-api.x.com "/11/accounts"
```

**Exemple de réponse**

```json theme={null}
{
  "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
     }
   ]
}
```

<div id="up-next">
  ## Ensuite . . .
</div>

* Lisez les notions fondamentales de la [documentation Ads API](https://developer.x.com/en/docs/twitter-ads-api), comme la [gestion des versions](https://developer.x.com/en/docs/twitter-ads-api/versioning) et la [hiérarchie](https://developer.x.com/en/docs/twitter-ads-api/hierarchy-terminology).
* Consultez les différents [outils et bibliothèques Ads API](https://developer.x.com/en/docs/twitter-ads-api/tools-and-libraries) pour vous aider dans votre intégration Ads API.
* Prenez connaissance des étapes pour [augmenter l’accès à l’Ads API](https://developer.x.com/en/docs/twitter-ads-api/increasing-access).
* Familiarisez-vous avec les [ressources d’assistance](https://developer.x.com/en/support/twitter-ads-api) disponibles.
* Suivez [@API](https://x.com/API) pour des mises à jour en temps réel sur les modifications de l’API, les problèmes de service et les améliorations apportées aux produits sponsorisés sur X.