Gruppi di risorse e utenti

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.

I gruppi di risorse business possono contenere account pubblicitari, Pagine, pixel di Facebook, insiemi di eventi offline, app, cataloghi, conversioni personalizzate e account Instagram. Le risorse possono essere di proprietà di un Business Manager o condivise per fornire l'accesso a un'agenzia.

Gruppi di risorse

Ottenere una lista dei gruppi

Per ottenere una lista di tutti i numeri di telefono associati a un'azienda, invia una richiesta GET all'endpoint BusinessBusinessAssetGroups.

Esempio di richiesta

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

Esempio di risposta

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

Ottenere un gruppo specifico

Per acquisire i dettagli di uno specifico gruppo di risorse business, invia una richiesta GET all'endpoint BusinessAssetGroup.

Esempio di richiesta

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

Esempio di risposta

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

Rinominare un gruppo

Per rinominare un gruppo di risorse specifico, invia una richiesta POST all'endpoint BusinessAssetGroup e imposta name sul nuovo valore.

Esempio di richiesta

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

Esempio di risposta

"success":  "true"

Eliminare un gruppo

Per eliminare uno specifico gruppo di risorse, invia una richiesta DELETE all'endpoint BusinessAssetGroup.

Esempio di richiesta

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

Esempio di risposta

"success":  "true"

Utenti

Campi utente pubblici per un utente che ha un ruolo nell'azienda che ha reclamato l'app.

Requisiti

• La funzione Accesso al profilo utente della risorsa business consente alle app business di leggere alcuni campi pubblici di un utente, purché questo abbia interagito con risorse di proprietà di un'azienda che ha rivendicato l'app.

Consulta il riferimento Accesso al profilo utente della risorsa business per una lista di campi utente leggibili.

Ottenere l'accesso utente ai gruppi

Per visualizzare una lista di tutti i gruppi di risorse business a cui un utente assegnato all'azienda può accedere, invia una richiesta GET all'endpoint BusinessScopedUser/AssignedBusinessAssetGroups.

Esempio di richiesta

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

Esempio di risposta

La risposta include ruoli che definiscono i livelli di accesso che un utente ha per tipo di risorsa:

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

Ottenere autorizzazioni utente

Per leggere una lista degli utenti assegnati a un gruppo di risorse, invia una richiesta GET all'endpoint BusinessAssetGroupAssignedUsers.

Esempio di richiesta

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

Esempio di risposta

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

Assegnare un utente a un gruppo di risorse

Per assegnare utenti a un gruppo di risorse business, invia una richiesta POST all'endpoint BusinessAssetGroupAssignedUsers.

Esempio di richiesta

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

Esempio di risposta

"success":  "true"

Rimuovere un utente da un gruppo di risorse

Per rimuovere un utente da un gruppo, invia una richiesta POST all'endpoint BusinessAssetGroup.

Esempio di richiesta

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

Esempio di risposta

"success":  "true"