Creare, recuperare e aggiornare un utente di sistema

Creazione

Usa il tuo token dell'utente di sistema con funzioni di amministratore o il token d'accesso dell'utente con funzioni di amministratore per creare un utente di sistema.

Nota: a un utente di sistema può essere concesso un ruolo su un'app solo se sia l'utente di sistema sia l'app appartengono allo stesso Business Manager. Se la tua app ha bisogno di accedere ai dati usando un utente di sistema e un token d'accesso appartenenti a un altro Business Manager, usa invece l'API Business On Behalf Of

Ecco le richieste necessarie per ottenere un token dell'utente di sistema ed effettuare chiamate API. I primi tre passaggi sono la configurazione che puoi completare anche in Business Manager. Quando crei il tuo primo utente di sistema, usi il token d'accesso di un utente reale, che è un admin del Business Manager.

Creare un utente di sistema amministratore e generare il token

1. Crea un utente di sistema con funzioni di amministratore con il tuo token d'accesso utente con funzioni di amministratore.
2. Installa l'app con l'utente di sistema con funzioni di amministratore usando il token d'accesso dell'utente con funzioni di amministratore.
3. Genera il token dell'utente di sistema con funzioni di amministratore usando il token d'accesso dell'utente con funzioni di amministratore.

Creare un utente di sistema

1. Crea un utente di sistema usando il token d'accesso dell'utente con funzioni di amministratore.
2. Oppure, crea un utente di sistema usando il token d'accesso di un utente di sistema con funzioni di amministratore del tuo Business Manager, se ne hai creato uno.

Genera il token d'accesso dell'utente di sistema

1. Installa l'app con l'utente di sistema usando il token d'accesso da: utente con funzioni di amministratore, utente di sistema con funzioni di amministratore o un altro utente di sistema.
2. Assegna autorizzazioni alle risorse (come account pubblicitari, Pagine) appartenenti al tuo Business Manager. Le autorizzazioni devono essere assegnate all'utente di sistema appena creato usando il token d'accesso da: utente con funzioni di amministratore o utente di sistema con funzioni di amministratore.
3. Genera il token d'accesso dell'utente di sistema utilizzando il token d'accesso dell'utente con funzioni di amministratore o dell'utente di sistema con funzioni di amministratore.
4. Ora usa il token d'accesso dell'utente di sistema per effettuare chiamate API sulle risorse business.

Per creare un utente di sistema o un utente di sistema con funzioni di amministratore tramite API, hai bisogno degli elementi seguenti:

• Un token d'accesso: di un utente con funzioni di amministratore o di un utente di sistema con funzioni di amministratore per questo Business Manager
• Ruolo: ADMIN o EMPLOYEE
• Nome: identificatore di questo utente di sistema o utente di sistema con funzioni di amministratore

Per creare un utente di sistema, effettua una richiesta POST:

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

In questo modo, ottieni un id per singola app del nuovo utente di sistema:

{
  "id" : "100000008899900"
}

Questo è l'ID per singola app per un utente di sistema. Per effettuare chiamate API devi usare questo ID, non l'ID canonico in Business Manager > System Users.

Recupero

Per ottenere la lista degli utenti di sistema, hai bisogno di un token d'accesso dell'utente con funzioni di amministratore o dell'utente di sistema con funzioni di amministratore. La lista include gli utenti di sistema con funzioni di amministratore e i rispettivi ID per singola app.

Effettua una richiesta GET:

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

La richiesta restituisce una lista di tutti gli utenti di sistema, compresi gli utenti di sistema con funzioni di amministratore, di proprietà di un Business Manager:

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

Aggiornamento

Puoi cambiare il nome di un utente di sistema o di un utente di sistema con funzioni di amministratore:

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"

Invalidare i token d'accesso

Non puoi eliminare un utente di sistema o un utente di sistema con funzioni di amministratore, ma puoi invalidare tutti i token d'accesso per l'utente. Invalida i token inviando una richiesta DELETE a:

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

La risposta restituisce true se la chiamata va a buon fine. Dopodiché, puoi generare nuovi token d'accesso per l'utente di sistema, come visto sopra.