Guida al Tool di esplorazione per la API Graph

Utilizzi comuni

• Genera rapidamente token d'accesso
• Ottieni campioni di codice per le tue query
• Genera informazioni di debug da includere nelle richieste di supporto
• Testa le query API con le impostazioni della tua app di produzione incluse autorizzazioni, funzioni e impostazioni per i tuoi casi d'uso
• Testa le query API con la tua app di test o di sviluppo usando autorizzazioni e funzioni su utenti o dati test

Requisiti

• Un account sviluppatore di Facebook
• Un'app per la quale hai un ruolo, come amministratore, sviluppatore o tester

Componenti

Token d'accesso

Quando ottieni un token d'accesso, viene visualizzato in alto a destra dello strumento. Questo è il token che viene incluso nella query API Graph. Puoi copiare questo token e usarlo nella tua app per testare il tuo codice.

Clicca sull'icona delle informazioni per visualizzare le informazioni sul token corrente, incluse l'app a cui è legato e le autorizzazioni che sono state concesse dall'utente che sta utilizzando l'app (che saresti tu).

Puoi generare un nuovo token d'accesso se il token è scaduto o se aggiungi nuove autorizzazioni.

App Meta

Il menu a discesa App Meta in alto a destra mostra tutte le app per le quali hai un ruolo di amministratore, sviluppatore o tester. Usa il menu a discesa per selezionare le impostazioni dell'app che desideri testare.

Utente o Pagina

Il menu a discesa Utente o Pagina ti consente di ottenere e scambiare token d'accesso dell'app, dell'utente e della Pagina per l'app attualmente selezionata. Puoi anche utilizzarlo per disinstallare un'app dal tuo nodo User, eliminando il token d'accesso corrente.

Autorizzazioni

Quando richiedi un token d'accesso dell'utente, per impostazione predefinita viene fornita solo un'autorizzazione, public_profile. Il menu a discesa Autorizzazione ti consente di selezionare autorizzazioni dati utente, come autorizzazioni email e user_photos, eventi, gruppi e Pagine, come manage_pages e ads_management e altre autorizzazioni, come instagram_basic e publish_video. Ciò consente all'utente dell'app corrente (che saresti tu) di concedere autorizzazioni specifiche per l'app. Concedi solo le autorizzazioni necessarie alla tua app.

Se la tua app è in fase di sviluppo, puoi concederle qualsiasi autorizzazione, che sarà rispettata dalle tue query per i dati di proprietà delle persone che hanno un ruolo nella tua app. Invece, se la tua app è stata pubblicata, concedere un'autorizzazione per cui la tua app non è stata approvata attraverso la procedura di analisi dell'app impedirà qualsiasi tentativo di invio di query.

Campo stringa della query

Quando accedi per la prima volta allo strumento appare una query predefinita. È possibile modificarla digitandone una nuova oppure cercando e selezionando i campi nel visualizzatore dei campi dopo l'esecuzione della query. Puoi anche utilizzare i menu a discesa per passare da un metodo di funzionamento all'altro e scegliere come targetizzare diverse versioni dell'API Graph.

Cliccando sull'icona a forma di stella alla fine del campo della query, questa viene salvata come preferita. Puoi visualizzare le query preferite cliccando sull'icona del libro.

Visualizzatore dei campi del nodo

Quando invii una query GET su un nodo, il visualizzatore dei campi situato nella parte sinistra della finestra mostra il nome del nodo e i campi restituiti dall'API Graph. Puoi modificare la query cercando e selezionando nuovi campi, cliccando sull'icona "+" e scegliendo tra i campi disponibili o deselezionando i campi non necessari. Queste azioni aggiornano in modo dinamico la query nel campo stringa della query.

Finestra di risposta

La risposta, situata sotto la stringa della query, mostra i risultati ottenuti dalla tua ultima domanda inviata.

Acquisizione del codice

Se la query ti soddisfa, clicca sul pulsante Ottieni codice situato in basso al centro, sotto la risposta, per generare un codice di esempio in base alla query. Di solito, non puoi copiare e incollare il codice di esempio direttamente nella tua base di codice, ma questo costituisce un utile punto di partenza.

Copia delle informazioni di debug

Se decidi di contattare l'Assistenza per gli sviluppatori perché non riesci a inviare la query e non sai quale sia il motivo, clicca su questo pulsante situato in basso al centro per copiare i dettagli della query e della risposta negli appunti. Puoi inviare queste informazioni insieme alla richiesta di supporto per aiutarci a capire quale sia il problema.

Salvataggio della sessione

Clicca sul pulsante Salva sessione situato in basso al centro per salvare lo stato della query, con il token d'accesso rimosso. Se decidi di contattare l'Assistenza per gli sviluppatori, includi il link a questa sessione.

Esempio di query

Prova a eseguire la query predefinita che viene visualizzata al primo caricamento del Tool di esplorazione per la API Graph. Se non lo hai già fatto, apri il tool di esplorazione per la API Graph in una nuova finestra, seleziona l'app che desideri testare dal menu a discesa dell'app e ricevi un token d'accesso dell'utente.

La query predefinita viene visualizzata nel campo stringa della query:

GET https://developers.facebook.com/v21.0/me?fields=id,name

La query predefinita richiede i campi id e name sul nodo /me, ovvero un nodo speciale associato al nodo /User o /Page identificato dal token. Poiché stai usando un token d'accesso dell'utente, questo viene associato al tuo nodo User.

I campi id e name sono disponibili pubblicamente e vengono restituiti se l'utente ha concesso alla tua app l'autorizzazione default o public_profile. Queste autorizzazioni sono pre-approvate per tutte le app (puoi verificare l'approvazione cliccando sull'icona delle informazioni nel campo Token d'accesso), in modo da non dover concedere all'app alcuna autorizzazione aggiuntiva per il funzionamento della query. Clicca su Ricevi token d'accesso e conferma che desideri concedere alla tua app l'accesso alle tue informazioni sull'utente disponibili pubblicamente.

Dopo l'invio della query dovresti vedere il nome e l'ID utente per singola app nella finestra di risposta.