Gestion des éléments

Vous pouvez obtenir et ajouter des éléments dans un groupe d’éléments, 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.

Pages

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

curl -i -X GET \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_pages?access_token=<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. Vous pouvez ajouter à la fois des pages administrées et des pages partagées :

curl -i -X POST \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_pages?asset_id=<ID>&access_token=<TOKEN>"

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

Pour supprimer une Page :

curl -i -X DELETE \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_pages?asset_id=<ID>&access_token=<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 lire les comptes d’un groupe :

curl -i -X GET \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_adaccounts?access_token=<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 :

curl -i -X POST \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_adaccounts?asset_id=<ID>&access_token=<TOKEN>"

Pour supprimer un compte publicitaire :

curl -i -X DELETE \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_adaccounts?asset_id=<ID>&access_token=<TOKEN>"

Catalogues produits

Vous pouvez ajouter à la fois 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/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_product_catalogs?access_token=<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 :

curl -i -X POST \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_product_catalogs?asset_id=<ID>&access_token=<TOKEN>"

En cas de réussite, nous renvoyons la valeur true. Pour supprimer un catalogue :

curl -i -X DELETE \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_product_catalogs?asset_id=<ID>&access_token=<TOKEN>"

Comptes Instagram

Vous pouvez ajouter à la fois des comptes Instagram partagés et 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/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_instagram_accounts?access_token=<TOKEN>"

La réponse se présente comme suit :

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

Pour ajouter un compte Instagram :

curl -i -X POST \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_instagram_accounts?asset_id=<ID>&access_token=<TOKEN>"

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

Pour supprimer un compte :

curl -i -X DELETE \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_instagram_accounts?asset_id=<ID>&access_token=<TOKEN>"

Pixels Facebook

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

curl -i -X GET \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_pixels?access_token=<TOKEN>"

La réponse se présente comme suit :

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

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

curl -i -X POST \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_pixels?asset_id=<ID>&access_token=<TOKEN>"

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

Pour supprimer un pixel :

curl -i -X DELETE \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_pixels?asset_id=<ID>&access_token=<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 :

curl -i -X GET \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_offline_conversion_data_sets?access_token=<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 :

curl -i -X POST \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_offline_conversion_data_sets?asset_id=<ID>&access_token=<TOKEN>"

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

Pour supprimer un ensemble d’évènements :

curl -i -X DELETE \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_offline_conversion_data_sets?asset_id=<ID>&access_token=<TOKEN>"

Applications

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

curl -i -X GET \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_applications?access_token=<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 :

curl -i -X POST \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_applications?asset_id=<ID>&access_token=<TOKEN>"

Pour supprimer une application :

curl -i -X DELETE \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_applications?asset_id=<ID>&access_token=<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 :

curl -i -X GET \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_custom_conversions?access_token=<TOKEN>"

Réponse :

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

Pour ajouter des conversions personnalisées :

curl -i -X POST \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_custom_conversions?asset_id=<ID>&access_token=<TOKEN>"

Pour supprimer des conversions personnalisées :

curl -i -X DELETE \
 "https://graph.facebook.com/<VERSION>/<BUS_ASSET_GROUP_ID>/contained_custom_conversions?asset_id=<ID>&access_token=<TOKEN>"

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