Introduzione: sviluppo di app utilizzando l'API Data Portability

L'API Data Portability consente di creare applicazioni che richiedono l'autorizzazione a un utente per spostare una copia dei dati dai servizi Google nella tua applicazione. Ciò consente la portabilità dei dati e facilita il cambio di servizio.

Se cerchi informazioni sulle modalità di condivisione dei dati da parte degli utenti, consulta Condividere una copia dei tuoi dati con terze parti.

Prerequisiti

Prima di rilasciare l'app, deve essere approvata da Google.

Dovresti inoltre verificare che l'API Data Portability sia disponibile per gli utenti nella tua località. Per un elenco dei paesi e delle regioni supportati, consulta le Domande comuni nella pagina "Condividere una copia dei tuoi dati con terze parti".

Flusso di lavoro degli sviluppatori

Di seguito sono riportati i passaggi da seguire per creare un'applicazione che utilizza l'API Data Portability.

1. Implementare il flusso di consenso OAuth per l'utente. In questo esempio, l'utente fornisce l'accesso ai dati dei video di YouTube.

   1. L'utente fa clic su Importa video di YouTube e accede al proprio Account Google.

   2. L'app inoltra l'utente a un URL per il consenso OAuth. Tieni presente che questo URL di esempio è semplificato e mancano alcuni parametri:

      https://accounts.google.com/o/oauth2/v2/auth?scope=https://www.googleapis.com/auth/dataportability.myactivity.youtube

   3. L'utente fa clic su Avanti nella schermata per il consenso OAuth, accetta di condividere i propri dati e fornisce l'accesso all'account.

   4. L'utente viene reindirizzato all'app.

   5. Lo sviluppatore ottiene un token OAuth per l'utente.

2. La tua app chiama InitiatePortabilityArchive(resources = ["myactivity.youtube"]) con un token OAuth collegato che contiene questo ambito OAuth:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

   Questa chiamata avvia il processo di creazione dell'archivio dati. Devi avviare l'archivio di portabilità entro 24 ore dall'autorizzazione dell'utente.

3. L'app chiama GetPortabilityArchiveState(job_id) con un token OAuth collegato contenente questo ambito OAuth:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

   Puoi chiamare questo metodo più volte per recuperare lo stato del job di archiviazione. Il metodo restituisce lo stato del job. Se lo stato è COMPLETATO, l'archivio è pronto e vengono forniti gli URL di Cloud Storage firmati. Tieni presente che il tempo necessario per completare la richiesta di archiviazione può variare da minuti a ore, a seconda delle dimensioni dei dati.

4. Scarica l'archivio dati utilizzando gli URL firmati.

5. Richiama ResetAuthorization() con un token OAuth collegato per reimpostare le risorse esaurite e rimuovere tutti i consensi OAuth.

Per ulteriori informazioni sull'utilizzo dei metodi dell'API Data Portability, consulta Metodi dell'API Call Data Portability.

In che modo gli utenti interagiscono con un'app dell'API Data Portability

Questo diagramma mostra in che modo gli utenti interagiscono con un'app integrata con l'API Data Portability.

1. Innanzitutto, all'utente viene offerta la possibilità di recuperare i propri dati.

2. Successivamente, l'utente accede al proprio Account Google.

3. Successivamente, l'utente fa clic su Avanti quando gli viene richiesto di condividere i dati e fa clic su OK quando gli viene richiesto di accettare le norme sulla privacy.

4. All'utente viene quindi mostrata una schermata per il consenso OAuth, che viene utilizzata per consentire all'applicazione di accedere ai suoi dati. Le opzioni qui corrispondono agli ambiti OAuth che hai configurato.

5. Dopo aver consentito l'accesso, viene avviata l'importazione dei dati. A seconda delle dimensioni dei dati, il completamento della richiesta può richiedere da alcuni minuti a diverse ore.