Créer, récupérer et mettre à jour un·e utilisateur·ice système

Créer

Pour créer un·e utilisateur·ice système, utilisez votre token d’utilisateur·ice système admin ou votre token d’accès d’utilisateur·ice admin.

Remarque : un·e utilisateur·ice système ne peut se voir affecter un rôle pour une application que si l’utilisateur·ice système et l’application appartiennent à la même entreprise. Si votre application a besoin d’accéder à des données via un compte d’utilisateur·ice système et un token d’accès appartenant à une autre entreprise, utilisez plutôt l’API Business On Behalf Of.

Les requêtes suivantes vous permettront de générer un token d’utilisateur·ice système et d’effectuer des appels d’API. Les trois premières étapes se rapportent à une configuration que vous pouvez également effectuer dans Business Manager. Lors de la création de votre premier·ère utilisateur·ice système, vous utiliserez le token d’accès d’un·e véritable utilisateur·ice ayant le rôle d’admin du compte Business Manager.

Créer un·e utilisateur·ice système admin et générer un token

1. Créez un·e utilisateur·ice système admin avec votre propre token d’accès d’utilisateur·ice admin.
2. Installez l’application en tant qu’utilisateur·ice système admin en utilisant le token d’accès de l’utilisateur·ice admin.
3. Générez le token de l’utilisateur·ice système admin en utilisant celui de l’utilisateur·ice admin.

Créer un·e utilisateur·ice système

1. Créez un·e utilisateur·ice système en utilisant le token d’accès de l’utilisateur·ice admin.
2. Autre solution : créez un·e utilisateur·ice système à l’aide du token d’accès d’un·e utilisateur·ice système admin de votre compte Business Manager, si vous en avez généré un.

Générer le token d’accès de l’utilisateur·ice système

1. Installez l’application en tant qu’utilisateur·ice système en utilisant le token d’accès de l’utilisateur·ice admin, de l’utilisateur·ice système admin ou d’un·e autre utilisateur·ice système.
2. Attribuez des autorisations pour les différents éléments (comptes publicitaires, Pages, etc.) appartenant à votre compte Business Manager. Pour attribuer des autorisations à l’utilisateur·ice système que vous venez de créer, utilisez le token d’accès de l’utilisateur·ice admin ou de l’utilisateur·ice système admin.
3. Générez le token d’accès de l’utilisateur·ice système en utilisant celui de l’utilisateur·ice admin ou de l’utilisateur·ice système admin.
4. À présent, utilisez le token d’accès de l’utilisateur·ice système pour effectuer des appels d’API sur les éléments professionnels.

Pour créer un·e utilisateur·ice système (admin ou standard) via l’API, vous avez besoin des éléments suivants :

• Le token d’accès d’un·e utilisateur·ice admin ou d’un·e utilisateur·ice système admin pour ce compte Business Manager
• Un rôle : ADMIN ou EMPLOYEE
• Un nom : identifiant de l’utilisateur·ice système (admin ou standard)

Pour créer un·e utilisateur·ice système, envoyez une requête POST :

curl \
-F "name=Ad Server" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

Cette requête renvoie l’id spécifique à l’application de l’utilisateur·ice système nouvellement créé·e :

{
  "id" : "100000008899900"
}

Il s’agit de l’ID spécifique à l’application qui est associé à un·e utilisateur·ice système. Nous vous recommandons de l’utiliser pour effectuer des appels d’API, au lieu de l’ID canonique dans Business Manager > System Users.

Récupérer

Pour obtenir la liste des utilisateur·ices système, vous avez besoin du token d’accès d’un·e utilisateur·ice admin ou d’un·e utilisateur·ice système admin. La liste répertorie les utilisateur·ices système admins, ainsi que leurs ID spécifiques à l’application.

Envoyez une requête GET :

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>>"

Cette requête renvoie la liste des utilisateur·ices système appartenant au compte Business Manager, y compris les utilisateur·ices système admins :

{
  "data": [
    {
      "id": "1000081799813",
      "name": "Reporting server"
      "role": "ADMIN",
    }, 
  ]
}

Mettre à jour

Vous pouvez changer le nom d’un·e utilisateur·ice système (admin ou standard) à l’aide du code suivant :

curl \
-F "system_user_id=<APP_SCOPED_SYSTEM_USER_ID>" \
-F "name=FBX Server" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

Invalider les tokens d’accès

Il est impossible de supprimer un·e utilisateur·e système (admin ou standard). Par contre, vous pouvez invalider tous ses tokens d’accès. Invalidez les tokens en envoyant une requête DELETE à l’adresse suivante :

https://graph.facebook.com/<API_VERSION>/<APP_SCOPED_SYSTEM_USER_ID>/access_tokens

Si l’appel aboutit, la requête renvoie true. Vous pouvez ensuite générer de nouveaux tokens d’accès pour l’utilisateur·ice système en suivant la méthode précédente.