Asset-Gruppen und Nutzer*innen

Verwalte die Asset-Gruppen deines Unternehmens und erfahre, wie du die Nutzer*innen deines Unternehmens mit Asset-Gruppen verbindest. Business-Asset-Gruppen helfen großen Werbetreibenden oder Agenturen dabei, Nutzer*innen und Assets in ihrem Unternehmen effizient zu verwalten. Sie sollten Assets und Nutzer*innen so organisieren, dass sie den realen Operationen zugeordnet werden. Beispielsweise kann ein Unternehmen seine Assets und Nutzer*innen nach Marke, Region, Kund*innen oder einem Organisationsprinzip seiner Wahl strukturieren.

Business-Asset-Gruppen können Werbekonten, Seiten, Facebook-Pixel, Offline-Event-Sets, Apps, Kataloge, selbstdefinierte Conversions und Instagram-Konten sein. Die Assets können einem Unternehmen gehören oder geteilt werden, um einer Agentur Zugriff zu gewähren.

Asset-Gruppen

Liste mit Gruppen abrufen

Um eine Liste aller Asset-Gruppen abzurufen, die mit einem Unternehmen verknüpft sind, sende eine GET-Anfrage an den BusinessBusinessAssetGroups-Endpunkt.

Beispielanfrage

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

Beispielantwort

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

Spezifische Gruppe abrufen

Um Details zu einer bestimmten Business-Asset-Gruppe abzurufen, sende eine GET-Anfrage an den BusinessAssetGroup-Endpunkt.

Beispielanfrage

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

Beispielantwort

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

Gruppe umbenennen

Um eine spezifische Asset-Gruppe umzubenennen, sende eine POST-Anfrage an den BusinessAssetGroup-Endpunkt und setze name auf den neuen Wert.

Beispielanfrage

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

Beispielantwort

"success":  "true"

Gruppe löschen

Um eine bestimmte Asset-Gruppe zu löschen, sende eine DELETE-Anfrage an den BusinessAssetGroup-Endpunkt.

Beispielanfrage

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

Beispielantwort

"success":  "true"

Nutzer*innen

Öffentliche Nutzer*innen-Felder für Nutzer*innen, die eine Rolle im Unternehmen innehaben, das die App beansprucht hat.

Voraussetzungen

• Das Feature „Zugriff auf Benutzerprofil mit Business Assets“ ermöglicht es Business-Apps, einen kleinen Satz von öffentlichen Feldern für eine*n Nutzer*in zu lesen, solange der*die Nutzer*in Assets verwendet hat, die einem Unternehmen gehören, das die App beansprucht hat.

Eine Liste der lesbaren Nutzer*innen-Felder findest du in der Referenz zu Zugriff auf Benutzerprofil mit Business Assets .

Zugriff von Nutzer*innen auf Gruppen abrufen

Um eine Liste aller Business-Asset-Gruppen anzuzeigen, auf die ein*e unternehmensbezogene*r Nutzer*in zugreifen kann, sende eine GET-Anfrage an den BusinessScopedUser/AssignedBusinessAssetGroups-Endpunkt.

Beispielanfrage

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

Beispielantwort

Die Antwort enthält Rollen, die die Zugriffsebenen von Nutzer*innen pro Asset-Typ definieren:

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

Berechtigungen von Nutzer*innen abrufen

Um eine Liste der zugewiesenen Nutzer*innen für eine Asset-Gruppe abzurufen, sende eine GET-Anfrage an den BusinessAssetGroupAssignedUsers-Endpunkt.

Beispielanfrage

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

Beispielantwort

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

Nutzer*innen einer Asset-Gruppe zuweisen

Um einer Business-Asset-Gruppe Nutzer*innen zuzuweisen, sende eine POST-Anfrage an den BusinessAssetGroupAssignedUsers-Endpunkt.

Beispielanfrage

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

Beispielantwort

"success":  "true"

Nutzer*innen aus einer Asset-Gruppe entfernen

Um Nutzer*innen von einer Gruppe zu entfernen, sende eine POST-Anfrage an den BusinessAssetGroup-Endpunkt.

Beispielanfrage

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

Beispielantwort

"success":  "true"