Gestione delle risorse

Puoi ottenere, aggiungere ed eliminare risorse da un gruppo di risorse business. Questo include account pubblicitari, Pagine, pixel di Facebook, insiemi di eventi offline, app, cataloghi, conversioni personalizzate e account Instagram.

Gestisci i gruppi di risorse business e scopri come collegare gli utenti business ai gruppi di risorse. I gruppi di risorse business aiutano grandi inserzionisti o agenzie a gestire in modo efficiente gli utenti e le risorse del loro Business Manager. Dovresti organizzare risorse e utenti in modo che siano mappati rispetto alle operazioni reali. Ad esempio, un Business Manager può strutturare le proprie risorse e gli utenti in base a brand, area geografica, cliente o a un principio organizzativo di sua scelta.

Pagine

Per ottenere una lista di tutte le pagine Facebook che fanno parte di un gruppo di risorse business:

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

La risposta si presenta così:

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

Puoi aggiungere una pagina a un gruppo di risorse business. Puoi aggiungere pagine di proprietà o pagine condivise:

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

In caso di azione eseguita correttamente, viene restituito true.

Per rimuovere una pagina da un gruppo di risorse business:

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

In caso di azione eseguita correttamente, viene restituito true.

Account pubblicitari

I gruppi di risorse business possono contenere account pubblicitari di proprietà o condivisi. Per vedere tutti gli account di un gruppo:

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

La risposta si presenta così:

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

Per aggiungere un account pubblicitario a un gruppo di risorse business:

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>"

Per rimuovere un account pubblicitario da un gruppo di risorse business:

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>"

Cataloghi prodotti

A un gruppo di risorse business puoi aggiungere cataloghi prodotti di proprietà o condivisi. Per vedere tutti i cataloghi di un gruppo:

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

La risposta si presenta così:

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

Per aggiungere un catalogo a un gruppo di risorse business:

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>"

In caso di azione eseguita correttamente, viene restituito true. Per rimuovere un catalogo da un gruppo di risorse business:

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>"

Account Instagram

A un gruppo di risorse business puoi aggiungere account Instagram condivisi o di proprietà. Per ottenere una lista degli account esistenti:

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

La risposta si presenta così:

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

Per aggiungere un account Instagram a un gruppo di risorse business:

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>"

In caso di azione eseguita correttamente, viene restituito true.

Per rimuovere un account da un gruppo di risorse business:

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

Pixel di Facebook

Puoi aggiungere o rimuovere pixel di proprietà e condivisi nei gruppi di risorse business. Per vedere tutti i pixel esistenti in un gruppo di risorse business:

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

La risposta si presenta così:

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

Per aggiungere un pixel a un gruppo di risorse business:

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

In caso di azione eseguita correttamente, viene restituito true.

Per rimuovere un pixel da un gruppo di risorse business:

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

Dataset di eventi offline

I gruppi di risorse business possono contenere dataset di eventi offline condivisi e di proprietà. Per vedere tutti i dataset di un gruppo di risorse business:

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

La risposta si presenta così:

{
 "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 } ], 
 ....
 }

Per aggiungere insiemi di eventi offline a un gruppo di risorse business:

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>"

In caso di azione eseguita correttamente, viene restituito true.

Per rimuovere un insieme di eventi da un gruppo di risorse business:

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>"

App

Per ottenere tutte le app condivise e di proprietà in un gruppo di risorse business:

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

Risposta:

{
 "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>" } ], 
 ....
 }

Per aggiungere un'app a un gruppo di risorse business:

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

Per rimuovere un'app da un gruppo di risorse business:

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

Quando aggiungi o rimuovi un'app, viene restituito true.

Conversioni personalizzate

Per vedere tutti gli insiemi di dati sulle conversioni personalizzate di proprietà e condivise in un gruppo di risorse business:

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

Risposta:

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

Per aggiungere conversioni personalizzate a un gruppo di risorse business:

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>"

Per eliminare conversioni personalizzate da un gruppo di risorse business:

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>"

Quando aggiungi o rimuovi le conversioni personalizzate, viene restituito true.