Gestion des éléments

Vous pouvez obtenir et ajouter des éléments dans un groupe d’éléments professionnels, ainsi que supprimer des éléments de ce groupe. Les éléments comprennent les comptes publicitaires, les Pages, les pixels Facebook, les ensembles d’évènements hors ligne, les applications, les catalogues, les comptes Instagram et les conversions personnalisées.

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, la clientèle ou un autre principe de son choix.

Pages

Pour obtenir la liste de toutes les Pages Facebook qui font partie d’un groupe d’éléments professionnels :

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

La réponse se présente comme suit :

{
  "data": [
    {
      "name": "Sample Name",
      "id": "<ID>"
    },
    {
      "name": "Another Name",
      "id": "<ID>"
    },
    {
      "name": "Third Name",
      "id": "<ID>"
    }
  ],
  ....
}

Vous pouvez ajouter une Page à un groupe d’éléments professionnels. Vous pouvez ajouter des pages administrées ou des pages partagées :

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_pages?asset_id=<PAGE_ID>&access_token=<ACCESS_TOKEN>"

En cas de réussite, nous renvoyons la valeur true.

Pour supprimer une Page d’un groupe d’éléments professionnels :

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

En cas de réussite, nous renvoyons la valeur true.

Comptes publicitaires

Les groupes d’éléments professionnels peuvent contenir des comptes publicitaires administrés ou des comptes publicitaires partagés. Pour afficher tous les comptes d’un groupe :

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

La réponse se présente comme suit :

{
  "data": [
    {
      "account_id": "<ID>",
      "id": "act_<ID>"
    },
    {
      "account_id": "<ID>",
      "id": "act_<ID>"
    },
    {
      "account_id": "<ID>",
      "id": "act_<ID>"
    }
  ],
....
    }
  }
}

Pour ajouter un compte publicitaire à un groupe d’éléments professionnels :

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_adaccounts?asset_id=<AD_ACCOUNT_ID>&access_token=<ACCESS_TOKEN>"

Pour supprimer un compte publicitaire d’un groupe d’éléments professionnels :

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

Catalogues produits

Vous pouvez ajouter des catalogues produits administrés et des catalogues produits partagés à un groupe d’éléments professionnels. Pour voir tous les catalogues d’un groupe :

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

La réponse se présente comme suit :

{
  "data": [
    {
      "id": "<ID>",
      "name": "1 product catalog"
    },
    {
      "id": "<ID>",
      "name": "First_Catalog_Products"
    }
  ],
....
}

Pour ajouter un catalogue à un groupe d’éléments professionnels :

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_product_catalogs?asset_id=<CATALOG_ID>&access_token=<ACCESS_TOKEN>"

En cas de réussite, nous renvoyons la valeur true. Pour supprimer un catalogue d’un groupe d’éléments professionnels :

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

Comptes Instagram

Vous pouvez ajouter des comptes Instagram partagés ou des comptes Instagram administrés à un groupe d’éléments professionnels. Pour obtenir la liste des comptes existants :

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

La réponse se présente comme suit :

{
  "data": [
    {
      "id": "<ID>"
    },
    {
      "id": "<ID>"
    }
  ],
  ....
}

Pour ajouter un compte Instagram à un groupe d’éléments professionnels :

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_instagram_accounts?asset_id=<INSTAGRAM_ACCOUNT_ID>&access_token=<ACCESS_TOKEN>"

En cas de réussite, nous renvoyons la valeur true.

Pour supprimer un compte d’un groupe d’éléments professionnels :

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

Pixels Facebook

Vous pouvez ajouter ou supprimer des pixels administrés et partagés dans des groupes d’éléments professionnels. Pour voir tous les pixels existants d’un groupe d’éléments professionnels :

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

La réponse se présente comme suit :

{
  "data": [
    {
      "id": "<ID>"
    },
    {
      "id": "<ID>"
    }
  ],
 ....
    }
  }
}

Pour ajouter un pixel à un groupe d’éléments professionnels :

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_pixels?asset_id=<PIXEL_ID>&access_token=<ACCESS_TOKEN>"

En cas de réussite, nous renvoyons la valeur true.

Pour supprimer un pixel d’un groupe d’éléments professionnels :

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

Ensembles de données d’évènements hors ligne

Les groupes d’éléments professionnels peuvent contenir des ensembles de données d’évènements hors ligne partagés et administrés. Pour voir tous les ensembles de données d’un groupe d’éléments professionnels :

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

La réponse se présente comme suit :

{
 "data": [
 {
 "id": "<ID>", "name": "Transfer", "business": {
 "id": "<ID>", "name": "Acme Industries Inc." }, "enable_auto_assign_to_accounts": false, 
 "is_restricted_use": false 
 },
 {
 "id": "<ID>", "name": "Default Offline Event Set For Biz1", "business": {
 "id": "<ID>", "name": "Biz1" }, "enable_auto_assign_to_accounts": true, "is_restricted_use": false } ], 
 ....
 }

Pour ajouter des ensembles d’évènements hors ligne à un groupe d’éléments professionnels :

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_offline_conversion_data_sets?asset_id=<EVENT_SET_ID>&access_token=<ACCESS_TOKEN>"

En cas de réussite, nous renvoyons la valeur true.

Pour supprimer un ensemble d’évènements d’un groupe d’éléments professionnels :

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

Applications

Pour obtenir toutes les applications partagées et administrées d’un groupe d’éléments professionnels :

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

Réponse :

{
 "data": [
 {
 "category": "Games", "link": "/instantgames/<ID>/", "name": "testing again", "id": "<ID>" }, {
 "category": "Lifestyle", "link": "https://www.facebook.com/games/?app_id=<ID>", "name": "AccountKitTest", "id": "<ID>" } ], 
 ....
 }

Pour ajouter une application à un groupe d’éléments professionnels :

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_applications?asset_id=<APP_ID>&access_token=<ACCESS_TOKEN>"

Pour supprimer une application d’un groupe d’éléments professionnels :

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

Lorsque vous ajoutez ou supprimez avec succès une application, nous renvoyons la valeur true.

Conversions personnalisées

Pour voir tous les ensembles de données de conversions personnalisées administrées et partagées d’un groupe d’éléments professionnels :

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

Réponse :

{
 "data": [{
  "data": [
    {
      "id": "<ID>"
    },
    {
      "id": "<ID>"
    }
  ],
  ....
}

Pour ajouter des conversions personnalisées à un groupe d’éléments professionnels :

curl -i -X POST \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/contained_custom_conversions?asset_id=<CUSTOM_CONVERSIONS_DATA_SET_ID>&access_token=<ACCESS_TOKEN>"

Pour supprimer des conversions personnalisées d’un groupe d’éléments professionnels :

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

Lorsque vous ajoutez ou supprimez avec succès une conversion personnalisée, nous renvoyons la valeur true.