Übersicht über das Management von Assets

Ein Unternehmen kann auf mehrere Assets zugreifen. Dein Unternehmen besitzt die Assets oder dein Unternehmen greift als Agentur darauf zu. Nutze Facebooks Business Management Asset APIs, um die Beziehung zwischen einem Unternehmen und seinen Assets hinzuzufügen, zu entfernen oder abzufragen, um Business-Assets zu verwalten und auf die Assets zuzugreifen.

Business-Asset-Gruppen

Business-Asset-Gruppen helfen großen Werbetreibenden oder Agenturen, 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 den Zugang zu einer Agentur bereitzustellen.

Du kannst diese API verwenden, um Nutzer*innen zu einer Business-Asset-Gruppe hinzuzufügen. Nach dem Hinzufügen kannst du Personen Berechtigungen für Assets in einer Business-Asset-Gruppe gewähren. So kannst du Zugriff auf mehrere Assets gleichzeitig gewähren, ohne zu viele Admins auf Unternehmensebene zu erstellen.

Mit dieser API kannst du Business-Asset-Gruppen verwalten, die bereits mit dem Business Manager erstellt wurden, oder du kannst Assets innerhalb der Business-Asset-Gruppe verwalten. Du kannst Folgendes tun:

• Eine Liste der Business Asset-Gruppen, die mit einem Unternehmen verbunden sind, abrufen
• Eine Business-Asset-Gruppe löschen oder umbenennen
• Alle Assets in einer Business-Asset-Gruppe anzeigen
• Nutzer*innenberechtigungen für Assets in einer Business-Asset-Gruppe abrufen, hinzufügen, bearbeiten und löschen
• Nutzer*innen einer Business-Asset-Gruppe zuweisen
• Assets aus einer Business-Asset-Gruppe abrufen, hinzufügen und löschen

Berechtigungen

Um die Business Asset Groups API zu verwenden, benötigt deine App die passende Marketing API-Zugriffsstufe:

• Für das Hinzufügen und Entfernen aller Endpunkte: Der*die Nutzer*in des Zugriffsschlüssels muss Admin des Unternehmens sein. Ansonsten wird der Zugriff verweigert.
• Für alle API-Endpunkte benötigt deine App eine business_management-Berechtigung.

Du brauchst zusätzliche Berechtigungen für:

Einschränkungen

Es wird ein Fehler angezeigt, wenn du versuchst, die Berechtigungen für ein Asset, das in einer Business-Asset-Gruppe enthalten ist, über die folgenden API-Aufrufe zu reduzieren oder zu entfernen:

• DELETE-Anfrage an /{page_id}/assigned_users
• POST-Anfrage an /{page_id}/assigned_users
• DELETE-Anfrage an /act_{ad_account_id}/assigned_users
• POST-Anfrage an /act_{ad_account_id}/assigned_users.

Befolge diese Schritte, um Berechtigungen zu reduzieren oder zu entfernen:

1. Tätige einen Aufruf, um eine Liste der Asset-Gruppen zu erhalten, die mit einem Unternehmen verbunden sind. Suche nach Asset-Gruppen, bei denen contained_asset_id gleich der {page_id} oder {ad_account_id} ist.
2. Führe für jede zurückgegebene Business-Asset-Gruppen-ID einen API-Aufruf durch, um eine*n Nutzer*in aus dieser Gruppe zu entfernen.
3. Rufe dann die obigen DELETE- oder POST-Anfragen auf, um die Berechtigung für diese*n Nutzer*in auf der Seite oder im Werbekonto zu entfernen.

Wenn du Funktionen zur Berechtigungsverwaltung in deiner App für andere Unternehmen bereitstellst, solltest du diese API verwenden, um Unstimmigkeiten und Fehler zwischen der API und dem Business Manager zu vermeiden.

Du kannst keine Berechtigungen für Apps, Kataloge, Instagram-Konten und selbstdefinierte Conversions über die Business-Asset-Gruppe festlegen. Stattdessen solltest du Berechtigungen auf Asset-Ebene zuweisen.

Wenn du zum Beispiel Roger zu einer Business-Asset-Gruppe in Jaspers Business Manager hinzufügst, kann er Berechtigungen für alle Seiten, Werbekonten, Pixel usw. in dieser Business-Asset-Gruppe erhalten. Um jedoch Rogers Berechtigungen für jedes Asset in Jaspers Business-Asset-Gruppe zu entfernen oder zu bearbeiten, musst du dies in der Business-Asset-Gruppe selbst durchführen.

Du kannst Nutzer*innenberechtigungen auf Asset-Ebene mit der Asset API hinzufügen, z. B. eine*n Seitenmoderator*in zu einem*einer Admin ernennen. Siehe Beispiele für Seite und Werbekonto.

Zulässige Rollen

Wenn ein*e Nutzer*in zu einem Unternehmen hinzugefügt wird, kann eine der beiden folgenden Rollen über die Business Users APIs zugewiesen werden:

Kataloge

Die folgenden Rollen können jedem*jeder Nutzer*in des Unternehmens, Admin oder Mitarbeiter*in, für Kataloge, auf die dieses Unternehmen zugreifen kann, über Catalog APIs zugewiesen werden:

Werbekonten

Die folgenden Aufgaben können jedem*jeder Nutzer*in des Unternehmens für Werbekonten, auf die dieses Unternehmen zugreifen kann, über Ad Account APIs zugewiesen werden:

Seiten

Du kannst die folgenden Aufgaben jedem*jeder Nutzer*in eines Unternehmens für Seiten, auf die dieses Unternehmen zugreifen kann, über die Page APIs zuweisen:

Apps

Es gibt keine Rollen- oder Task Management-APIs für Apps im Business Manager.

Instagram-Konten

Es gibt kein Rollenmanagement für Instagram-Konten im Business Manager. Nutzer*innen mit Zugriff auf Werbekonten, die mit Instagram-Konten verbunden sind, können Werbeanzeigen für diese Instagram-Konten schalten.