API Graph

Primi passi

Questa guida illustra come iniziare a ricevere dati dal social graph di Facebook.

Prima di iniziare

Ecco cosa ti servirà:

Prima richiesta

Passaggio 1: apertura del Tool di esplorazione per la API Graph

Apri il Tool di esplorazione per la API Graph in una nuova finestra del browser, in modo da poter eseguire gli esempi mentre leggi questo tutorial.

Il tool viene caricato con una query predefinita con il metodo GET, l'ultima versione dell'API Graph, il nodo /me e i campi id e name nel campo della stringa della query e la tua app Facebook.

Passaggio 2: generazione di un token d'accesso

Clicca sul pulsante Genera token d'accesso. Viene mostrata la finestra Accedi con Facebook. Con questa finestra a comparsa, l'app ti chiede l'autorizzazione per acquisire il tuo nome e l'immagine del profilo da Facebook.

Questo flusso è quello del nostro prodotto Facebook Login, che consente a una persona di accedere a un'app utilizzando le proprie credenziali di Facebook. Facebook Login consente a un'app di chiedere a una persona, che può accettare o rifiutare, di potere accedere ai suoi dati di Facebook. Il tuo nome e l'immagine del profilo sono pubblici, in modo da consentire alle persone di trovarti su Facebook, quindi non sono necessari requisiti aggiuntivi per eseguire questa richiesta.

Clicca su Continua come...

Viene creato un token d'accesso dell'utente, che contiene informazioni come l'app che effettua la richiesta, la persona che utilizza l'app per la richiesta, se il token d'accesso è ancora valido (ha una validità di circa un'ora), l'ora di scadenza e l'ambito dei dati che possono essere richiesti dall'app. In questa richiesta, l'ambito è public_profile, che comprende il tuo nome e l'immagine del profilo.

Clicca sull'icona a forma di cerchio "i" accanto al token d'accesso per visualizzarne le informazioni.

Passaggio 3: invio della richiesta

Clicca sul pulsante Invia nell'angolo in alto a destra.

Cosa dovresti vedere

Nella finestra di risposta, viene riportata una risposta JSON con l'ID utente di Facebook e il tuo nome.

Se rimuovi ?fields=id,name dal campo della stringa della query e clicchi su Invia, vedrai lo stesso risultato poiché name e id sono i campi del nodo User restituiti per impostazione predefinita.

Seconda richiesta

Passaggio 1: aggiunta di un campo

Rendiamo un po' più complessa la prima richiesta aggiungendo un altro campo: email. Hai a disposizione due modi per aggiungere i campi:

Aggiungi il campo email e clicca su Invia.

Cosa dovresti vedere

Anche se la chiamata non ha avuto esito negativo, sono stati restituiti solo i campi name e id insieme a un messaggio di debug. Clicca sul link (Mostra) per effettuare il debug della richiesta.

Quasi tutti i nodi e i campi necessitano di un'autorizzazione specifica per l'accesso. Il messaggio di debug ti informa che devi concedere all'app l'autorizzazione per accedere all'indirizzo e-mail associato al tuo account Facebook.

Passaggio 2: aggiunta di un'autorizzazione

Nella scheda a destra, in Autorizzazioni, clicca sul menu a discesa Aggiungi un'autorizzazione. Clicca su Autorizzazioni dati utente e seleziona e-mail.

Generazione di un nuovo token d'accesso dell'utente

Poiché stai modificando l'ambito del token d'accesso, devi creare un nuovo token. Clicca su Genera token d'accesso. Come per la prima richiesta, nella finestra di dialogo Facebook Login devi autorizzare l'app ad accedere alla tua e-mail.

Dopo aver creato il nuovo token, clicca su Invia. Ora verranno restituiti tutti i campi nella richiesta.

Prova a recuperare i tuoi post di Facebook.

Consulta i passaggi.

Link nella risposta

Tieni presente che i valori id restituiti nella finestra di risposta sono link, che possono rappresentare nodi, come User, Page o Post. Se clicchi su un link, l'ID sostituirà il contenuto del campo della stringa della query. A questo punto puoi eseguire richieste su quel nodo specifico. Poiché questo nodo è connesso al nodo principale, ad esempio un post di un utente, potresti non dover aggiungere autorizzazioni. Clicca sull'ID di un post, che utilizzeremo nell'esempio successivo.

Avviso: alcuni ID sono una combinazione dell'ID principale e di una nuova stringa ID. Ad esempio, il post di un utente presenterà un ID del post simile a questo: 1028223264288_102224043055529 dove 1028223264288 corrisponde all'ID utente.

Diamo un'occhiata a un segmento

Il nodo User non dispone di molti segmenti in grado di restituire dati. L'accesso agli oggetti User può essere concesso solo dall'utente che possiede l'oggetto. Nella maggior parte dei casi, un utente possiede un oggetto se lo ha creato.

Ad esempio, se pubblichi un post puoi vedere le informazioni relative, come quando è stato creato, il testo, le foto e i link condivisi nel post e il numero di reazioni ricevute. Se commenti un ​​tuo post, puoi recuperare il commento, ma se un'altra persona pubblica un commento sul tuo post, non puoi vedere né il commento né chi lo ha pubblicato.

Prova a recuperare il numero di reazioni a uno dei tuoi post. Potrebbe interessarti il

riferimento per le reazioni agli oggetti.

Consulta i passaggi.

Acquisizione del codice per la tua richiesta

Il tool di esplorazione ti consente di testare le richieste e, dopo aver ricevuto una risposta corretta, puoi ottenere il codice da inserire in quello della tua app. Nella parte inferiore della finestra di risposta, clicca su Ottieni il codice. Il codice del tool di esplorazione può essere usato per Android, iOS, JavaScript, PHP e cURL ed è preselezionato, quindi devi solo copiare e incollare.

Ti consigliamo di implementare l'SDK di Facebook per la tua app, che comprende Facebook Login, con cui l'app può chiedere autorizzazioni e ottenere token d'accesso.

Ulteriori informazioni

Puoi utilizzare il Tool di esplorazione per la API Graph per testare qualsiasi richiesta per utenti, Pagine, gruppi e non solo. Visita il riferimento per ogni nodo o segmento per conoscere l'autorizzazione e il tipo di token d'accesso necessari.