Effettuare l'aggiornamento all'ultima versione dell'API Graph
Questa guida descrive come preparare la propria app a testare diverse versioni dell'API Graph e all'aggiornamento all'ultima versione.
Lo Strumento di aggiornamento API mostra le chiamate all'API dalla tua app che potrebbero essere interessate da modifiche nelle versioni più recenti dell'API. Sarai in grado di vedere rapidamente quali modifiche devi apportare per passare dalla versione corrente a una versione più recente.
In che modo una modifica influisce sull'app
Lo Strumento di aggiornamento dell'API visualizza una lista personalizzata di modifiche che hanno un impatto su un'app quando si esegue l'aggiornamento a una versione di destinazione specificata. Ciò consente di visualizzare tutte le modifiche rilevanti tra la versione di origine e quella di destinazione.
Passaggio 1. Nello Strumento di aggiornamento, seleziona la tua app dal menu a discesa o digita il nome dell'app.
Il menu a discesa elenca un massimo di dieci app. Per visualizzare più app di quelle elencate, utilizza la barra di ricerca nel menu a discesa.
Passaggio 2. Utilizza i menu a discesa a destra per selezionare la versione da cui desideri eseguire l'aggiornamento (Aggiornamento da) e la versione verso cui desideri eseguire l'aggiornamento (Aggiornamento a).
Lettura dei risultati
Lo strumento mostra il numero di modifiche necessarie per aggiornare l'app alla versione selezionata. Se la tua app effettua chiamate API che non saranno interessate da una versione più recente, non saranno restituiti dati.
I metodi sono codificati per colore in base alla versione che influisce sulla chiamata. Passa il cursore del mouse sul grafico a barre per vedere il numero di modifiche di ogni versione. Le date associate a ogni versione indicano quando verranno applicate le modifiche a tutte le app.
La tabella mostra il tipo di modifica (elemento obsoleto, nuova funzione o modifica), i metodi interessati, il numero di chiamate effettuate negli ultimi 7 giorni e la percentuale delle chiamate all'API interessate da una data modifica.
Limitazioni
- Devi essere un amministratore o uno sviluppatore dell'app per visualizzare l'app nello strumento.
- Se la tua app non ha effettuato alcuna chiamata o ha effettuato troppe poche chiamate all'API dalla versione Aggiornamento da, non saranno restituiti dati.
- I volumi delle chiamate potrebbero risultare errati. La registrazione delle chiamate all'API viene campionata e aggregata alla settimana precedente. Viene confrontata con il volume delle chiamate per stimare quante delle tue chiamate potrebbero essere interessate da un determinato cambio di versione.
Nota: non tutte le modifiche possono influire su tutte le chiamate all'API. Usa il buon senso per determinare se una particolare modifica debba essere gestita dalla tua app. Assicurati di testare le chiamate all'API nella nuova versione per verificarne il corretto funzionamento.
Implementare una nuova versione
Nella Dashboard gestione app, in Impostazioni > Avanzate, scorri fino alla sezione Aggiorna la versione dell'API.
Aggiornamento di sviluppatori e amministratori
Aggiorna tutti gli sviluppatori e gli amministratori di un'app alla successiva versione disponibile. Ti consente di testare le modifiche con un piccolo sottoinsieme di utenti reali prima di rilasciare la nuova versione al pubblico.
Aggiornamento di tutte le chiamate
Aggiorna tutte le chiamate effettuate da un'app alla successiva versione disponibile. L'aggiornamento nelle prime fasi è utile poiché dà la possibilità di tornare alla versione originale in caso di bug o problemi imprevisti.
Scopri di più
- Registro modifiche dell'API Graph: scopri di più sulle modifiche dell'ultima versione.
- Gestione delle versioni: scopri tutto ciò che c'è da sapere sulla gestione delle versioni dell'API Graph, sulle richieste di versioni diverse e molto altro ancora.
- App test: scopri come creare app test per testare le modifiche alla tua app prima del rilascio al pubblico.
- Utenti test: scopri come creare utenti test per testare le modifiche alla tua app prima del rilascio al pubblico.