Erstellen, Abrufen und Aktualisieren eines Systemnutzers

Erstellen

Verwende deinen Admin-Systemnutzer-Schlüssel oder deinen eigenen Admin-Nutzer*innen-Zugriffsschlüssel, um einen Systemnutzer zu erstellen.

Hinweis: Einem Systemnutzer kann nur dann eine Rolle in einer App erteilt werden, wenn sowohl der Systemnutzer als auch die App zum selben Unternehmen gehören. Wenn deine App über einen Systemnutzer und Zugriffsschlüssel eines anderen Unternehmens auf Daten zugreifen muss, verwende stattdessen die Business On Behalf Of API.

Hier siehst du die Anfragen, die zum Abrufen eines Systemnutzer-Schlüssels und zum Tätigen von API-Aufrufen erforderlich sind. Die ersten drei Schritte sind Setup-Schritte, die du auch im Business Manager durchführen kannst. Beim Erstellen deines ersten Systemnutzers verwendest du den Zugriffsschlüssel eines*einer echten Nutzer*in, der*die ein admin des Business Manager ist.

Admin-Systemnutzer erstellen und Schlüssel generieren

1. Erstelle einen Admin-Systemnutzer mit deinem eigenen Admin-Nutzer*innen-Zugriffsschlüssel.
2. Installiere die App mit dem Admin-Systemnutzer und verwende hierbei den Zugriffsschlüssel des*der Admin-Nutzer*in.
3. Generiere den Admin-Systemnutzer-Zugriffsschlüssel mit dem Zugriffsschlüssel des*der Admin-Nutzer*in.

Systemnutzer erstellen

1. Erstelle einen Systemnutzer mit dem Zugriffsschlüssel des*der Admin-Nutzer*in.
2. Erstelle alternativ einen Systemnutzer mit dem Zugriffsschlüssel eines Admin-Systemnutzers in deinem Business Manager, falls du einen zuvor erstellt hast.

Systemnutzer-Zugriffsschlüssel generieren

1. Installiere die App mit dem Systemnutzer und verwende hierbei den Zugriffsschlüssel eines*einer Admin-Nutzer*in, eines Admin-Systemnutzers oder eines anderen Systemnutzers.
2. Erteile Berechtigungen für Assets (z. B. Werbekonten, Seiten), die deinem Business Manager gehören. Berechtigungen sollten dem neu erstellten Systemnutzer mit dem Zugriffsschlüssel eines*einer Admin-Nutzer*in oder eines Admin-Systemnutzers erteilt werden.
3. Generiere den Systemnutzer-Zugriffsschlüssel mit dem Zugriffsschlüssel eines*einer Admin-Nutzer*in oder eines Admin-Systemnutzers.
4. Verwende nun den Systemnutzer-Zugriffsschlüssel, um API-Aufrufe für Business-Assets zu tätigen.

Um einen Systemnutzer oder Admin-Systemnutzer über die API zu erstellen, benötigst du Folgendes:

• Einen Zugriffsschlüssel eines*einer Admin-Nutzer*in oder eines Admin-Systemnutzers für diesen Business Manager
• Rolle: ADMIN oder EMPLOYEE
• Name: Kennung dieses Systemnutzers oder Admin-Systemnutzers

Tätige zum Erstellen eines Systemnutzers eine POST-Anfrage:

curl \
-F "name=Ad Server" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

Dadurch wird die App-spezifische id des neuen Systemnutzers zurückgegeben:

{
  "id" : "100000008899900"
}

Das ist die App-spezifische ID für einen Systemnutzer. Du solltest diese ID zum Tätigen von API-Aufrufen und nicht die kanonische ID in Business Manager > System Users verwenden.

Abrufen

Um die Liste der Systemnutzer abzurufen, benötigst du den Zugriffsschlüssel eines*einer Admin-Nutzer*in oder eines Admin-Systemnutzers. Die Liste enthält Admin-Systemnutzer und ihre App-spezifischen IDs.

Starte eine GET-Anfrage:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>>"

Dies gibt eine Liste aller Systemnutzer (einschließlich Admin-Systemnutzer) zurück, die einem Business Manager gehören:

{
  "data": [
    {
      "id": "1000081799813",
      "name": "Reporting server"
      "role": "ADMIN",
    }, 
  ]
}

Aktualisieren

Du kannst den Namen eines Systemnutzers oder Admin-Systemnutzers folgendermaßen ändern:

curl \
-F "system_user_id=<APP_SCOPED_SYSTEM_USER_ID>" \
-F "name=FBX Server" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

Zugriffsschlüssel ungültig machen

Du kannst keinen Systemnutzer oder Admin-Systemnutzer löschen, aber du kannst alle Zugriffsschlüssel für diesen Nutzer ungültig machen. Mache Schlüssel ungültig, indem du eine DELETE-Anfrage an die folgende URL sendest:

https://graph.facebook.com/<API_VERSION>/<APP_SCOPED_SYSTEM_USER_ID>/access_tokens

Die Antwort gibt true zurück, wenn der Aufruf erfolgreich ist. Anschließend kannst du wie oben beschrieben neue Zugriffsschlüssel für den Systemnutzer erstellen.