Elenco di controllo per sviluppatori

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

1. Prima di iniziare

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

Rivedi le norme dell'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 la gestione della riautenticazione degli utenti.

2. Configurare l'integrazione

Configura Google Cloud: segui le istruzioni riportate in Configura Google Cloud e OAuth per creare un progetto Google Cloud, attivare l'API Google Health e configurare le credenziali OAuth 2.0.

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 degli ambiti, 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

Effettua la tua prima chiamata API: se non hai mai utilizzato l'API Google Health, segui il Codelab per effettuare 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 test: mentre l'app è in modalità "Test" in Google Cloud, aggiungi utenti di test per testare l'integrazione con gli account nella lista consentita.

Recupera dati: utilizza gli endpoint dei tipi 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 in tutti i periodi di dati.

Gestire gli errori: consulta la guida alla risoluzione dei problemi per conoscere gli errori 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. Inserisci le notifiche in arrivo in una coda ed elaborale separatamente. Consulta le best practice relative ai 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 un controllo di 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 in Google Cloud Console.

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