Autorisation

Pour accéder aux points de terminaison de l’API Marketing, votre application doit passer plusieurs niveaux d’autorisation de l’API Graph.

Couche 1 : types d’application

Lorsque vous créez une application Facebook, vous êtes invité·e à indiquer le type d’utilisation prévu pour cette application. Lʼoption que vous choisissez détermine son type : Entreprise, Jeux vidéo ou Aucun. Consultez les types d’application.

Pour accéder aux points de terminaison de l’API Marketing, vous devez créer une application Business. Consultez les produits disponibles pour les applications Business.

Une fois votre application enregistrée, vous pouvez attribuer un rôle à toute personne disposant d’un compte de développeur·se qui vous aidera au développement de l’application.

Couche 2 : niveaux d’accès, autorisations et fonctionnalités

Les applications Entreprise sont soumises à une couche supplémentaire d’autorisation de l’API Graph appelée Niveaux d’accès. Durant le Contrôle app, vous devez également demander des autorisations et fonctionnalités spécifiques pour votre application.

Niveaux d’accès aux fonctionnalités

Niveau d'accès aux fonctionnalités	Description
Accès standard	Les applications Entreprise sont automatiquement approuvées pour l’Accès standard à toutes les autorisations et fonctionnalités disponibles pour ce type d’application. Utilisez cette option si vous démarrez. Vous pouvez créer des flux de travail de bout en bout avant de demander l’ensemble des autorisations. Vous pouvez accéder à un nombre illimité de comptes publicitaires. Certains appels d’API peuvent ne pas être disponibles avec un Accès standard, car ils peuvent provenir de plusieurs comptes, ou parce que le compte affecté ne peut pas être identifié par programmation.
Accès avancé	L’accès avancé doit être approuvé via le processus Contrôle app sur la base d’une autorisation ou d’une fonctionnalité individuelle. Pour demander l’accès Avancé, accédez à l’espace de votre application, puis cliquez sur Contrôle app > Autorisations et fonctionnalités. Trouvez l’autorisation ou la fonctionnalité à laquelle vous souhaitez accéder et, sous Action, cliquez sur Demander un accès Avancé. Vous pouvez sélectionner une ou plusieurs fonctionnalités. Une fois vos options sélectionnées, cliquez sur Continuer la demande. Un écran permettant de vous guider dans le processus de demande s’affiche. Une fois que vos informations ont été soumises, Facebook approuve ou refuse votre demande et vous informe des raisons pour lesquelles celle-ci a été refusée, le cas échéant. Si l’accès avancé est approuvé, vous devez procéder comme suit pour conserver votre statut : Vous devez avoir effectué au moins 1 500 appels à l’API Marketing au cours des 15 derniers jours. Vous devez avoir émis des appels d’API Marketing avec un taux d’erreur inférieur à 10 % au cours des 15 derniers jours.

Niveau d'accès aux fonctionnalités

Description

Accès standard

Les applications Entreprise sont automatiquement approuvées pour l’Accès standard à toutes les autorisations et fonctionnalités disponibles pour ce type d’application.

Utilisez cette option si vous démarrez. Vous pouvez créer des flux de travail de bout en bout avant de demander l’ensemble des autorisations. Vous pouvez accéder à un nombre illimité de comptes publicitaires.

Certains appels d’API peuvent ne pas être disponibles avec un Accès standard, car ils peuvent provenir de plusieurs comptes, ou parce que le compte affecté ne peut pas être identifié par programmation.

Accès avancé

L’accès avancé doit être approuvé via le processus Contrôle app sur la base d’une autorisation ou d’une fonctionnalité individuelle.

Pour demander l’accès Avancé, accédez à l’espace de votre application, puis cliquez sur Contrôle app > Autorisations et fonctionnalités.

Trouvez l’autorisation ou la fonctionnalité à laquelle vous souhaitez accéder et, sous Action, cliquez sur Demander un accès Avancé. Vous pouvez sélectionner une ou plusieurs fonctionnalités. Une fois vos options sélectionnées, cliquez sur Continuer la demande. Un écran permettant de vous guider dans le processus de demande s’affiche.

Une fois que vos informations ont été soumises, Facebook approuve ou refuse votre demande et vous informe des raisons pour lesquelles celle-ci a été refusée, le cas échéant.

Si l’accès avancé est approuvé, vous devez procéder comme suit pour conserver votre statut :

Vous devez avoir effectué au moins 1 500 appels à l’API Marketing au cours des 15 derniers jours.
Vous devez avoir émis des appels d’API Marketing avec un taux d’erreur inférieur à 10 % au cours des 15 derniers jours.

Chaque niveau comporte des restrictions ; voir Niveaux d’accès et fonctionnalités. Les développeur·ses doivent également se conformer à toutes les Conditions générales de la plateforme Facebook et Politiques développeur. Les appels passés sont destinés aux données de production, quel que soit le niveau d’accès.

Pour connaître votre niveau d’accès actuel, accédez à Espace app > Contrôle app > Autorisations et fonctionnalités.

Accès à l’API Ads et accès standard à la gestion des publicités

Accès à l’API Marketing	Accès standard à la gestion des publicités	Action
Accès au développement	Accès standard	Par défaut
Accès standard	Accès Avancé	Requiert une demande dans l’Espace app

Autorisations et fonctionnalités

Les autorisations à demander varient en fonction de l’API à laquelle vous souhaitez accéder.

Si votre application gère uniquement votre compte publicitaire, l’Accès standard ainsi que les autorisations ads_read et ads_management suffisent. Si elle gère le compte publicitaire d’autres personnes, vous avez besoin de l’accès avancé, ainsi que des autorisations ads_read et/ou ads_management. Consultez la liste des autorisations disponibles pour les applications d’entreprise.

Les fonctionnalités à demander varient en fonction de l’utilisation que vous prévoyez de faire de nos API. Si vous gérez des publicités, il est courant de demander la fonctionnalité Ads Management Standard Access. Consultez la liste des fonctionnalités disponibles pour les applications d’entreprise.

Pour obtenir un accès Avancé à la fonctionnalité Accès standard à la gestion des publicités, votre application doit répondre aux exigences suivantes :

Vous devez avoir effectué au moins 1 500 appels à l’API Marketing au cours des 15 derniers jours.
Vous devez avoir émis des appels d’API Marketing avec un taux d’erreur inférieur à 10 % au cours des 15 derniers jours.

Si vous gérez les publicités d’une personne, utilisez le paramètre scope pour inviter une personne pour les autorisations ads_management ou ads_read. Votre application obtient l’accès lorsque quelqu’un clique sur Autoriser :

https://www.facebook.com/v21.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

Lorsque vous remplissez le champ YOUR_URL, ajoutez / à la fin. Par exemple : http://www.facebook.com/.

Exemples

Cas d’utilisation	Ce qu’il faut demander
Vous voulez lire et gérer les publicités liées aux comptes publicitaires que vous détenez ou auxquelles vous êtes autorisé·e à accéder par le propriétaire du compte publicitaire.	Autorisation : `ads_management` Fonctionnalité : `Ads Management Standard Access`
Vous voulez lire les rapports publicitaires liés aux comptes publicitaires que vous détenez ou auxquels vous êtes autorisé·e à accéder par le propriétaire du compte publicitaire.	Autorisation : `ads_read` Fonctionnalité : `Ads Management Standard Access`
Vous voulez extraire les rapports publicitaires d’un ensemble de client·es, et lire et gérer à la fois les publicités d’un autre ensemble de client·es.	Autorisations : `ads_management` et `ads_read` Fonctionnalité : `Ads Management Standard Access`

Niveaux d’accès et fonctionnalités

Le tableau ci-dessous montre l’impact des niveaux d’accès Standard et Avancé sur la fonctionnalité Accès standard à la gestion des publicités.

	Accès standard	Accès Avancé
Limites de comptes	Gérez un nombre illimité de comptes publicitaires. Les admins ou développeur·ses d’applications peuvent émettre des appels d’API pour le compte d’admins ou d’annonceurs de comptes publicitaires.	Gérez un nombre illimité de comptes publicitaires, en partant du principe que vous obtenez une autorisation `ads_read` ou `ads_management` du compte publicitaire.
Limites de débit	Débit extrêmement limité par compte publicitaire. Pour le développement uniquement. Sont exclues les applications de production exécutées pour les annonceurs en direct.	Débit légèrement limité par compte publicitaire.
Business Manager	Accès limité aux API Business Manager et Product Catalog. Aucun accès Business Manager pour gérer des comptes publicitaires, des autorisations utilisateur·ice et des Pages.	Accès à toutes les API Business Manager et Product Catalog.
Utilisateur·ice système	Peut créer un·e utilisateur·ice système et un·e utilisateur·ice système admin.	Peut créer dix utilisateur·ices système et un·e utilisateur·ice système admin.
Création de pages	Ne peut pas créer de pages par l’intermédiaire de l’API.	Ne peut pas créer de pages par l’intermédiaire de l’API.

Différences entre les niveaux d’accès et la fonctionnalité Accès standard à la gestion des publicités

Les autorisations et les fonctionnalités des applications dépendent de leur niveau d’accès : Accès standard ou Accès avancé. Notez que le terme « Accès standard » utilisé ici ne fait pas référence à la fonctionnalité Accès standard à la gestion des publicités. Pour qu’une application bénéficie de l’accès Avancé à la fonctionnalité Accès standard à la gestion des publicités, vous devez la soumettre à un examen.

Couche 3 : vérification de l’entreprise

La vérification de l’entreprise est une procédure qui nous permet de vérifier l’identité de votre entreprise, ce qui est obligatoire si votre application doit accéder à des données sensibles. En savoir plus sur la procédure Vérification de l’entreprise.