Présentation de la gestion des éléments professionnels

Une entreprise peut accéder à plusieurs éléments. Votre entreprise est propriétaire des éléments ou accède à ces derniers en tant qu’agence. Les API Business Management Asset de Facebook vous permettent de créer et de supprimer des liens entre une entreprise et ses éléments, ou d’interroger ces liens, et de gérer des éléments professionnels et d’y accéder.

Le terme Agence désigne un type d’entreprise autorisée à gérer les éléments détenus par une autre entreprise ou à y accéder. Cette relation lui permet d’effectuer des tâches ou des actions spécifiques au nom du client ou de la cliente, comme gérer des comptes publicitaires, des Pages ou tout autre élément numérique.

Groupes d’éléments professionnels

Les groupes d’éléments professionnels aident les grands annonceurs ou les agences à gérer efficacement les utilisateur·ices et les éléments dans leur entreprise. Il est conseillé d’organiser les éléments et les utilisateur·ices de la même manière que dans le monde réel. Par exemple, une entreprise peut structurer ses éléments et ses utilisateur·ices selon la marque, la région, le client ou un autre principe de son choix.

Les groupes d’éléments professionnels peuvent contenir des comptes publicitaires, des Pages, des pixels Facebook, des ensembles d’évènements hors ligne, des applications, des catalogues, des conversions personnalisées et des comptes Instagram. Les éléments peuvent être détenus par une entreprise ou partagés pour les rendre accessibles à une agence.

Vous pouvez utiliser cette API pour ajouter des utilisateur·ices à un groupe d’éléments professionnels. Une fois les utilisateurs ou utilisatrices ajouté·es, vous pouvez leur accorder des autorisations d’accès à des éléments dans un groupe d’éléments professionnels. Vous pouvez ainsi accorder l’accès à plusieurs éléments simultanément, sans créer trop d’admins au niveau de l’entreprise.

Avec cette API, vous pouvez gérer des groupes d’éléments professionnels créés par d’autres utilisateur·ices via Business Manager ou administrer les éléments inclus dans le groupe d’éléments professionnels. Vous pouvez :

Obtenir une liste des groupes d’éléments professionnels associés à une entreprise
Supprimer ou renommer un groupe d’éléments professionnels
Afficher tous les éléments d’un groupe d’éléments professionnels
Obtenir, ajouter, modifier ou supprimer des autorisations utilisateur·ice d’accès à des éléments dans un groupe d’éléments professionnels
Affecter des utilisateur·ices à un groupe d’éléments professionnels
Obtenir, ajouter ou supprimer des éléments dans un groupe d’éléments professionnels

Autorisations

Pour pouvoir utiliser l’API Business Asset Groups, votre application doit disposer du niveau d’accès requis à l’API Marketing :

Pour tous les points de terminaison d’ajout et de suppression : l’utilisateur·ice associé·e au token d’accès doit faire partie des administrateur·ices de l’entreprise. Sinon, l’accès sera refusé.
Pour tous les points de terminaison de l’API, votre application a besoin de l’autorisation business_management.

Vous aurez besoin d’autorisations supplémentaires pour :

Points de terminaison du groupe d’éléments professionnels	Autorisations requises
Obtenir la liste des comptes publicitaires	`ads_management`
Obtenir la liste des catalogues produits, ajouter ou supprimer un catalogue produits	`ads_management`
Obtenir la liste des comptes Instagram, et ajouter ou supprimer un compte Instagram	`ads_management`. Si vous utilisez l’API Marketing 4.0, vous avez aussi besoin de l’autorisation `instagram_basic`.
Obtenir la liste des pixels	`ads_read`
Obtenir la liste des ensembles d’évènements hors ligne	`ads_management`
Obtenir la liste des conversions personnalisées	`ads_read`
Ajouter une conversion personnalisée	`ads_management`

Limites

Une erreur s’affiche si vous essayez de réduire ou de supprimer les autorisations pour un élément contenu dans un groupe d’éléments professionnels via les appels d’API suivants :

Demande DELETE à /{page_id}/assigned_users
Demande POST à /{page_id}/assigned_users
Demande DELETE à /act_{ad_account_id}/assigned_users
Demande POST à /act_{ad_account_id}/assigned_users.

Pour réduire ou supprimer des autorisations, procédez comme suit :

Envoyez un appel pour obtenir la liste des groupes d’éléments associés à une entreprise. Recherchez les groupes d’éléments dans lesquels contained_asset_id est égal à {page_id} ou {ad_account_id}.
Pour chaque identifiant de groupe d’éléments professionnels renvoyé, envoyez un appel d’API pour supprimer un utilisateur ou une utilisatrice de ce groupe.
Ensuite, envoyez les requêtes DELETE ou POST ci-dessus pour supprimer l’autorisation de l’utilisateur·ice en question sur la Page ou le compte publicitaire.

Si vous fournissez des fonctionnalités de gestion des autorisations dans votre application pour d’autres entreprises, nous vous recommandons d’utiliser cette API pour prévenir les incohérences et les erreurs entre l’API et Business Manager.

Vous ne pouvez pas définir des autorisations sur des applications, des catalogues, des comptes Instagram et des conversions personnalisées via le groupe d’éléments professionnels. Vous devez attribuer les autorisations au niveau de l’élément.

Par exemple, si vous ajoutez Roger à un groupe d’éléments professionnels dans le Business Manager de Jasper’s, il pourra obtenir les autorisations d’accès à toutes les Pages, tous les comptes publicitaires, tous les pixels, etc. inclus dans ce groupe d’éléments professionnels. Cependant, si vous souhaitez ensuite supprimer ou modifier les autorisations d’accès de Roger à des éléments du groupe d’éléments professionnels Jasper’s, vous devez le faire dans le groupe d’éléments professionnels lui-même.

Vous pouvez ajouter des autorisations d’utilisateur·ice au niveau de l’élément via l’API Asset, pour attribuer le statut d’admin à un·e modérateur·ice de Page par exemple. Consultez des exemples pour une Page et un Compte publicitaire.

Les groupes d’éléments professionnels ont remplacé l’API Projects le 13 octobre 2019. Veuillez migrer toutes les applications utilisant l’API Projects vers les groupes d’éléments professionnels.

Rôles autorisés

Lorsqu’un·e utilisateur·ice est ajouté·e à une entreprise, l’un des deux rôles suivants peut être affecté via les API relatives aux utilisateur·ices Business :

Constante d’API	Nom	Description
`ADMIN`	Administrateur·ice de l’entreprise	Peut gérer tous les aspects des paramètres de l’entreprise, notamment la modification ou la suppression du compte, ainsi que l’ajout ou la suppression d’utilisateur·ices.
`EMPLOYEE`	Employé·e de l’entreprise	Peut consulter toutes les informations figurant dans les paramètres de l’entreprise, mais ne peut apporter aucune modification, mis à part ajouter à l’entreprise des Pages ou des comptes publicitaires dont l’utilisateur·ice en question est admin.

Catalogues

Les rôles suivants peuvent être affectés à tout·e utilisateur·ice de l’entreprise, admin ou employé·e, pour les catalogues accessibles par cette entreprise en utilisant les API relatives aux catalogues :

Constante d’API	Nom	Description
`['MANAGE', 'ADVERTISE']`	Admin de catalogue	Peut gérer tous les aspects du catalogue produits avec un accès complet en lecture et en écriture, y compris pour créer/mettre à jour/supprimer des éléments, gérer les flux, rattacher le catalogue à des pixels et des applications, créer des ensembles de produits, diffuser des publicités de catalogue Advantage+ avec le catalogue, modifier les paramètres du catalogue produits, etc.
`['ADVERTISE']`	Annonceur de catalogue	Peut créer des ensembles de produits et diffuser des publicités de catalogue Advantage+ avec le catalogue. Ne peut pas modifier les paramètres, les produits ni les flux du catalogue.

Comptes publicitaires

Les tâches suivantes peuvent être affectées à tout·e utilisateur·ice de l’entreprise pour les comptes publicitaires accessibles par cette entreprise en utilisant les API relatives aux comptes publicitaires :

Constante d’API	Nom	Description
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	Admin de compte publicitaire	Peut gérer tous les aspects des campagnes, des rapports, de la facturation et des autorisations du compte, et peut définir les limites de dépense du compte publicitaire. Les admins de comptes publicitaires peuvent également associer des moyens de paiement de l’entreprise.
`['ADVERTISE', 'ANALYZE']`	Annonceur sur compte publicitaire	Peut visualiser, modifier et configurer des publicités en utilisant le moyen de paiement associé au compte publicitaire.
`['ANALYZE']`	Analyste de compte publicitaire	Peut visualiser les performances publicitaires.

Pages

Vous pouvez affecter les tâches suivantes à tout·e utilisateur·ice d’une entreprise pour les Pages accessibles par cette entreprise en utilisant les API relatives aux Pages :

Constante d’API	Nom	Description
`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Admin de Page	Peut gérer les rôles des Pages, envoyer des messages et publier au nom de la Page, créer des publicités et voir les statistiques.
`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Éditeur de Page	Peut modifier la Page, envoyer des messages et publier au nom de la Page, créer des publicités et voir les statistiques.
`['MODERATE', 'ADVERTISE', 'ANALYZE']`	Modérateur·ice de Page	Peut répondre aux commentaires et en supprimer sur la Page, envoyer des messages au nom de la Page, créer des publicités et voir les statistiques. Ne peut pas publier au nom de la Page.
`['ADVERTISE', 'ANALYZE']`	Annonceur de Page	Peut créer des publicités pour la Page et voir les statistiques. Ne peut pas publier au nom de la Page.
`['ANALYZE']`	Analyste de Page	Peut voir les statistiques. Ne peut pas publier au nom de la Page.

Applications

Il n’y a pas d’API de gestion des rôles ou des tâches pour les applications dans Business Manager.

Comptes Instagram

Il n’y a pas de gestion des rôles pour les comptes Instagram dans Business Manager. Les utilisateurs et utilisatrices qui ont accès aux comptes publicitaires associés à des comptes Instagram peuvent diffuser des publicités pour ces comptes Instagram.