Pagine

I Business Manager possono reclamare Pagine di loro proprietà. In questo modo, gli amministratori possono assegnare con facilità le persone alle Pagine a cui devono avere accesso.

Come reclamare le Pagine

I Business Manager possono reclamare la proprietà di una Pagina di loro proprietà, potendone così gestire tutti gli aspetti, compresa la rimozione di eventuali agenzie o altri Business Manager che hanno ottenuto l'accesso. In alternativa, i Business Manager possono anche richiedere l'accesso dell'agenzia a una Pagina e questo consentirà loro di pubblicare inserzioni sulla Pagina tramite account pubblicitari a cui hanno accesso.

Reclamare Pagine in qualità di Owner

Per reclamare una Pagina per il tuo Business Manager in qualità di OWNER, hai bisogno dell'ID della Pagina e dell'ID business. Quindi, devi inviare una richiesta POST:

Il richiedente deve avere:

autorizzazione di amministratore sulla Pagina;
autorizzazione per il Business Manager titolare (altrimenti, il proprietario del Business Manager titolare dovrà approvare la richiesta).

Per effettuare questa richiesta, devi usare il token d'accesso di un utente con diritti di amministratore o di un utente di sistema con funzioni di amministratore del tuo Business Manager. Se l'utente che effettua la chiamata è un amministratore o un MANAGER della Pagina da più di 7 giorni, la Pagina diventa immediatamente di proprietà del Business Manager. Nella risposta, Facebook restituisce il parametro access_status impostato su CONFIRMED. Se l'utente è diventato amministratore o MANAGER della Pagina da 7 giorni o meno, non approviamo automaticamente la richiesta API.

Se l'utente che effettua una chiamata di reclamo OWNER non dispone delle autorizzazioni appropriate sulla Pagina, la chiamata ha esito negativo. A differenza del reclamo di un account pubblicitario, non viene inviata alcuna richiesta che deve essere approvata dagli amministratori della Pagina.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Reclamare Pagine in qualità di Agency

Per reclamare una Pagina per il tuo Business Manager in qualità di AGENCY, hai bisogno dell'ID della Pagina. Quindi, devi inviare una richiesta POST:

Se il richiedente dispone dell'autorizzazione di amministratore sulla Pagina, la richiesta verrà approvata automaticamente. In caso contrario, l'amministratore della Pagina dovrà approvare la richiesta.

L'agenzia non può ricondividere la Pagina con un altro Business Manager.

L'agenzia può iniziare subito a pubblicare inserzioni sulla Pagina (tramite gli account pubblicitari a cui ha accesso).

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Se utilizzi AGENCY:

Devi fornire permitted_tasks
La Pagina deve essere di proprietà di un Business Manager
Il token d'accesso deve avere le autorizzazioni pages_manage_metadata e pages_show_list

Se effettui una richiesta di reclamo come AGENCY ma non disponi delle autorizzazioni appropriate per la Pagina, la risposta sarà PENDING. L'amministratore della Pagina può accedere e concedere l'accesso, negarlo o segnalare il reclamo come spam. Se un Business Manager ha troppe richieste di accesso alle Pagine segnalate come spam, lo blocchiamo.

Per vedere tutte le pagine dei clienti alle quali hai richiesto l'accesso ancora in attesa di approvazione, effettua questa chiamata GET. Hai bisogno del token d'accesso per l'utente di sistema con diritti di amministratore:

curl -G \
-d "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_client_pages"

Visualizzare Pagine di proprietà del Business Manager o Pagine che appartengono a clienti del Business Manager

Per vedere tutte le pagine che il tuo Business Manager possiede, usa questa chiamata GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Per vedere tutte le pagine di cui il tuo Business Manager è un'agenzia, usa questa chiamata GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

In questo modo, ottieni una lista delle pagine di proprietà dei clienti di un Business Manager.

Aggiunta di Pagine in grande quantità

Puoi aggiungere singole Pagine a un Business Manager usando l'interfaccia utente per Business Manager. Per aggiungere pagine in grande quantità a un Business Manager, effettua le seguenti chiamate POST:

curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'batch=[
  {
    "method":"POST",
    "name":"test1",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_1>"
  }, 
  {
    "method":"POST",
    "name":"test2",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_2>"
  }, 
  {
    "method":"POST",
    "name":"test3",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_3>"
  }, 
]' \
"https://graph.facebook.com/<API_VERSION>"

Dove:

<ACCESS_TOKEN> è un token d'accesso con l'autorizzazione business_management.
<BUSINESS_ID> è l'ID del Business Manager al quale devono essere assegnate le Pagine reclamate.
<PAGE_ID_n> sono gli ID delle Pagine da reclamare.

Rimozione di Pagine

Per rimuovere una Pagina dal Business Manager, effettua questa chiamata DELETE:

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

Aggiunta di persone alle Pagine

Una volta che il tuo Business Manager ha una Pagina, puoi assegnare attività alle persone per tale Pagina. Le attività includono:

Nome	Costante API	Descrizione
Amministratore	`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Può gestire i ruoli di amministratore, inviare messaggi e pubblicare contenuti a nome della Pagina, creare inserzioni e visualizzare i report.
Editore	`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Può modificare la Pagina, inviare messaggi e post a nome della Pagina, creare inserzioni e visualizzare i report.
Moderatore	`['MODERATE', 'ADVERTISE', 'ANALYZE']`	Può rispondere ai commenti sulla Pagina ed eliminarli, inviare messaggi a nome della Pagina, creare inserzioni e visualizzare i report.
Inserzionista	`['ADVERTISE', 'ANALYZE']`	Può creare inserzioni per la Pagina e visualizzare gli insight.
Analista	`['ANALYZE']`	Può visualizzare i report.

Hai bisogno di:

page_id: ID della Pagina
user_id: ID utente da aggiungere
Attività da assegnare

Effettua questa chiamata POST per aggiungere un utente con le attività ['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']:

L'ID business deve essere l'ID del Business Manager titolare della Pagina

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Modifica dell'accesso alla Pagina

Per modificare le attività di un utente esistente, utilizza la stessa chiamata POST che utilizzi per aggiungere un nuovo utente con attività:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Visualizzazione delle autorizzazioni per la Pagina

Per vedere le pagine con le autorizzazioni utente, effettua questa chiamata GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_pages"

Per vedere autorizzazioni specifiche su una Pagina, effettua questa chiamata GET:

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users?business=<BUSINESS_ID>"

Rimozione degli accessi alla Pagina

Prima di poter rimuovere una Pagina dal Business Manager, devi anche rimuovere gli amministratori di tale Pagina dal Business Manager.

Ecco gli elementi necessari per rimuovere l'accesso di un utente da una Pagina di tua proprietà:

page_id: ID della Pagina
user_id: ID dell'utente da rimuovere

La chiamata DELETE è:

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
-F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"