Groupes d’éléments et utilisateur·ices

Gérez les groupes de ressources de votre entreprise et découvrez comment y associer vos utilisateurs et utilisatrices. 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.

Groupes d’éléments

Obtenir la liste des groupes

Pour obtenir la liste des groupes d’éléments associés à une entreprise, envoyez une requête GET au point de terminaison BusinessBusinessAssetGroups.

Exemple de requête

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_asset_groups
    ?access_token=<ACCESS_TOKEN>"

Exemple de réponse

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Northern Region"
    },
    {
      "id": "BUSINESS-ID",
      "name": "Western Region"
    }
  ],
....
}

Obtenir un groupe spécifique

Pour obtenir des détails sur un groupe d’éléments professionnels spécifique, envoyez une requête GET au point de terminaison BusinessAssetGroup.

Exemple de requête

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Exemple de réponse

{
  "id": "BUSINESS-ASSET-GROUP-ID", "name": "BUSINESS-ASSET-GROUP-NAME"
}

Renommer le groupe

Pour renommer un groupe d’éléments spécifique, envoyez une requête POST au point de terminaison BusinessAssetGroup et définissez name sur la nouvelle valeur.

Exemple de requête

curl -i -X POST 
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
   ?name=BUSINESS-ASSET-GROUP-NAME
   &access_token=<ACCESS_TOKEN>"

Exemple de réponse

"success":  "true"

Supprimer le groupe

Pour supprimer un groupe d’éléments spécifique, envoyez une requête DELETE au point de terminaison BusinessAssetGroup.

Exemple de requête

curl -i -X DELETE 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Exemple de réponse

"success":  "true"

Utilisateur·ices

Champs publics relatifs à un·e utilisateur·ice disposant d’un rôle dans l’entreprise qui a revendiqué l’application.

Conditions requises

• La fonctionnalité Accès au profil de l’utilisateur des éléments professionnels permet aux applications d’entreprise de lire un ensemble restreint de champs publics sur un·e utilisateur·ice, à condition que cet·te utilisateur·ice ait interagi avec des éléments qui appartiennent à une entreprise ayant revendiqué l’application.

Pour obtenir la liste des champs utilisateur lisibles, reportez-vous à la référence concernant la fonctionnalité Accès au profil de l’utilisateur des éléments professionnels.

Obtenir les accès utilisateur·ice aux groupes

Pour voir la liste de tous les groupes d’éléments professionnels auxquels un·e utilisateur·ice spécifique à une entreprise peut accéder, envoyez une requête GET au point de terminaison BusinessScopedUser/AssignedBusinessAssetGroups.

Exemple de requête

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_business_asset_groups
    ?limit=1
    &access_token=<ACCESS_TOKEN>"

Exemple de réponse

Les rôles inclus dans la réponse définissent les niveaux d’accès de l’utilisateur·ice par type d’élément :

{
  "data": [
    {
      "id": "BUSINESS-ID" 
      "name": "USER NAME",      
      "page_roles": [ "ANALYZE", "ADVERTISE" ],
      "offline_conversion_data_set_roles": ["UPLOAD"],
      "adaccount_roles": ["ANALYZE", "ADVERTISE"],      
      "pixel_roles": ["ANALYZE", "EDIT"]    
    }  
    ],
        ....
}

Obtenir les autorisations d’utilisateur·ice

Pour lire la liste des utilisateur·ices affecté·es d’un groupe d’éléments, envoyez une requête GET au point de terminaison BusinessAssetGroupAssignedUsers.

Exemple de requête

curl -i -X GET
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?limit=2
    &business=<BUSINESS_ID>
    &access_token=<ACCESS_TOKEN>"

Exemple de réponse

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Dabney Donigan",
      "page_roles": [ "ANALYZE" ],  
      "offline_conversion_data_set_roles": [ "ADVERTISE", "UPLOAD", "MANAGE" ],
      "adaccount_roles": [ "ANALYZE" ],
      "pixel_roles": [ "ANALYZE", "EDIT" ]
      }
      ],
   ....
}

Affecter un·e utilisateur·ice à un groupe d’éléments

Pour affecter des utilisateur·ices à un groupe d’éléments professionnels, envoyez une requête POST au point de terminaison BusinessAssetGroupAssignedUsers.

Exemple de requête

curl -i -X POST 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=USER-ID 
    &page_roles=LIST-OF-PAGE-ROLES
    &adaccount_roles=LIST-OF-AD-ACCOUNT-ROLES
    &pixel_roles=LIST-OF-PIXEL-ROLES
    &offline_conversion_data_set_roles=LIST-OF-OFFLINE-CONVERSION-ROLES
    &access_token=<ACCESS_TOKEN>"

Exemple de réponse

"success":  "true"

Supprimer un·e utilisateur·ice d’un groupe d’éléments

Pour supprimer un·e utilisateur·ice d’un groupe, envoyez une requête POST au point de terminaison BusinessAssetGroup.

Exemple de requête

curl -i -X DELETE \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=<USER_ID>
    &access_token=<ACCESS_TOKEN>"

Exemple de réponse

"success":  "true"