Elenco di controllo per sviluppatori

Questo elenco di controllo fornisce una panoramica dei passaggi consigliati per lanciare la tua applicazione con l'integrazione dell'API Google Health.

1. Prima di iniziare

Consulta la documentazione per sviluppatori: scopri i tipi di dati, gli ambiti e gli endpoint API per determinare quali sono necessari per l'integrazione.

Esamina le norme relative all'API Google Health: assicurati che il tuo caso d'uso sia conforme ai Termini e condizioni per gli sviluppatori dell'API Google Health e alle Norme relative ai dati utente e per gli sviluppatori dell'API Google Health.

Pianifica l'esperienza utente: se esegui la migrazione degli utenti dall'API Fitbit Web, consulta le best practice nella Guida alla migrazione per gestire la riautenticazione degli utenti.

2. Configura l'integrazione

Configura Google Cloud: segui la procedura descritta in Configurare Google Cloud e OAuth per creare un progetto Google Cloud, abilitare l'API Google Health e configurare le credenziali OAuth 2.0. Utilizza progetti separati per la gestione temporanea e la produzione in modo che i test non influiscano sulla tua app pubblicata.

Configura la schermata per il consenso OAuth: nella console Google Cloud, configura la schermata per il consenso OAuth con le informazioni, il branding e i link della tua app alle norme sulla privacy e ai termini di servizio dell'app.

Aggiungi ambiti: nella console Google Cloud, aggiungi gli ambiti richiesti per i tipi di dati a cui la tua app deve accedere. Esamina l'implementazione dell'ambito, ad esempio richiedendo solo gli ambiti necessari, configurando l'accesso in scrittura solo quando invii dati e gestendo il consenso parziale in modo appropriato.

3. Sviluppare e testare

Esegui la tua prima chiamata API: se non hai mai utilizzato l'API Google Health, segui il Codelab per eseguire la tua prima chiamata API in pochi minuti.

Esegui la migrazione dall'API Fitbit Web: se esegui la migrazione dall'API Fitbit Web, consulta la guida alla migrazione e utilizza lo strumento di parità per confrontare le API.

Implementa OAuth 2.0: implementa l'autorizzazione OAuth 2.0 per ottenere il consenso dell'utente e i token API. Utilizza le librerie client per semplificare l'implementazione.

Aggiungi utenti di prova: mentre l'app è in modalità "Test in corso" in Google Cloud, aggiungi utenti di prova per testare l'integrazione con gli account nella lista consentita.

Recupera dati: utilizza gli endpoint del tipo di dati appropriati per recuperare i dati utente. Segui le best practice per recuperare i dati storici separandoli dall'onboarding, poiché i limiti di frequenza sono fissi per tutti i periodi di dati.

Gestisci gli errori: consulta la guida alla risoluzione dei problemi per conoscere gli errori più comuni e come gestirli.

Utilizza i webhook per gli abbonamenti: utilizza l'API di abbonamento per ricevere notifiche in tempo reale anziché eseguire il polling. Metti le notifiche in arrivo in una coda ed elaborale separatamente. Consulta le best practice per i webhook.

4. Prepararsi al lancio

Verifica OAuth: se la tua app deve supportare più di 100 utenti o se è pronta per il lancio pubblico, inviala per la verifica OAuth. Questa procedura può richiedere diversi giorni e include una revisione della sicurezza di terze parti e la verifica delle norme sulla privacy e dei termini di servizio della tua app.

Migrazione dell'API Fitbit Web: se esegui la migrazione, assicurati che il flusso di riautenticazione per la migrazione degli utenti sia fluido, seguendo i consigli della guida alla migrazione.

5. Lanciare e mantenere

Pubblica la tua app: una volta completata la verifica OAuth, pubblica la tua app in "In produzione" nella console Google Cloud per rimuovere il limite di 100 utenti.

Monitoraggio: monitora l'utilizzo delle API e i tassi di errore nella console Google Cloud.

Rimani al corrente: consulta le note di rilascio per aggiornamenti e ritiri delle API.