Panoramica
L'API Pages è un insieme di endpoint dell'API Graph di Facebook che le app possono utilizzare per creare e gestire le impostazioni e il contenuto di una Pagina.
Componenti
Token d'accesso
L'autenticazione dell'API viene gestita tramite i token d'accesso. La maggior parte degli endpoint richiede token d'accesso della Pagina, che sono unici per ogni Pagina, utente dell'app e app, e hanno una scadenza. Per ottenere un token da un utente dell'app, l'utente dell'app deve possedere o essere in grado di eseguire un'attività sulla Pagina.
Puoi ottenere i token d'accesso dagli utenti della tua app implementando Facebook Login.
Per le Pagine che sono state migrate alla Nuova esperienza della Pagina, ora è richiesto un token d'accesso alla Pagina per tutti gli endpoint disponibili, con le seguenti eccezioni:
API Graph
Se non hai familiarità con l'API Graph, leggi la nostra documentazione sull'API Graph prima di procedere per scoprire di più sul social graph di Meta.
Facebook Login
Facebook Login consente agli utenti di accedere alla tua app e alla tua app di chiedere agli utenti le autorizzazioni per accedere ai dati.
Facebook Login for Business
Facebook Login for Business è la soluzione di autenticazione e autorizzazione preferenziale per i fornitori di soluzioni tecnologiche e gli sviluppatori di app business che devono accedere alle risorse business dei loro clienti.
Funzioni
Alcuni endpoint richiedono funzioni che devono essere approvate tramite il processo di analisi dell'app prima che l'app possa utilizzarli in modalità live. Le funzioni ti consentono di accedere ai dati pubblici della Pagina senza autorizzazione o la possibilità di eseguire un'attività sulla Pagina. Consulta il riferimento di ogni endpoint per determinare quale funzione della Pagina richiede.
Menzioni
Le @menzioni consentono alla tua Pagina di rispondere pubblicamente a una persona specifica, che ha pubblicato qualcosa sulla tua Pagina o ha commentato un post sulla tua Pagina, in un commento o in una risposta.
ID utente per singola Pagina
Gli utenti che interagiscono con le Pagine sono identificati da ID utente per singola Pagina (PSID). I PSID sono ID unici per ciascuna coppia utente-Pagina. Gli endpoint dell'API Pages e della Piattaforma Messenger si basano sui PSID, quindi è possibile utilizzare un PSID per identificare le interazioni di un utente con una Pagina, nonché le conversazioni su Messenger pubbliche dell'utente con quella Pagina.
Autorizzazioni
La maggior parte degli endpoint richiede una o più autorizzazioni che devono essere concesse all'app dagli utenti. In genere questo può essere fatto tramite Facebook Login, ma anche tramite Business Manager, se la tua app è stata rivendicata da un Business Manager.
Per tutte le autorizzazioni, è necessario completare l'analisi dell'app prima che un utente possa concederle all'app mentre si trova in modalità live. Per le app business, che non hanno modalità, le autorizzazioni devono essere approvate per l'accesso avanzato prima che possano essere concesse all'app da un utente che non ricopre un ruolo nell'app o in un Business Manager che l'ha rivendicata.
Ricerca di Pagine
Trova informazioni sulle Pagine Facebook, inclusi nomi e luoghi e trova Pagine da @menzionare, luoghi delle Pagine e tagga una Pagina per mostrare contenuti brandizzati.
Rate limiting
Tutte le richieste degli endpoint delle Pagine sono soggette a rate limiting. Puoi vedere il consumo attuale del numero di chiamate della tua app nella Dashboard gestione app.
Attività
Le attività consentono agli utenti di eseguire azioni specifiche su una Pagina. Quando un utente utilizza un'app per interagire con una Pagina, in base all'azione tentata, verrà innanzitutto verificato che l'utente sia stato approvato per un'attività che consente quel tipo di azione.
Puoi approvare singoli utenti per le seguenti attività:
| Attività | Azioni consentite |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Se a una persona viene concesso l'accesso come amministratore a una Pagina nell'interfaccia utente, sarà in grado di svolgere tutte le attività su quella Pagina.
Piattaforma Messenger
Fai conversazioni su Messenger con i tuoi clienti o le persone interessate alla tua Pagina.
Webhook di Meta per le Pagine
Ricevi notifiche in tempo reale quando un utente commenta un post della Pagina o aggiunge una reazione a un post della tua Pagina.
Analisi dell'app
Tutte le autorizzazioni e funzioni relative alla Pagina devono essere approvate attraverso la procedura di analisi dell'app prima che la tua app possa usarle quando sarà in modalità live.
Le app in modalità sviluppo possono richiedere qualsiasi autorizzazione da qualsiasi utente dell'app che abbia un ruolo al suo interno.
Come funziona
Questo è un flusso tipico per accedere all'API Pages:
- Ottieni un token d'accesso dell'utente dall'utente dell'app tramite Facebook Login.
- Interroga l'endpoint
/me/accountsper ottenere l'ID e il token d'accesso della Pagina a cui l'utente dell'app ha autorizzato la tua app ad accedere. - Acquisisci l'ID Pagina e il token d'accesso della Pagina restituiti.
- Usa l'ID e il token per eseguire una query sul nodo Page.
Tieni presente che in alcuni casi l'utente dell'app potrebbe concedere alla tua app l'accesso a più di una Pagina, nel qual caso dovresti acquisire ogni ID pagina e il relativo token e fornire all'utente un modo per puntare verso ciascuna di quelle Pagine.
Passaggi successivi
Segui la nostra Guida introduttiva per imparare a pubblicare un post sulla Pagina utilizzando l'API Pages.
Altri contenuti da consultare
Sviluppo di app con MetaAutenticazione e autorizzazione | Guide per le PagineRiferimenti |