Introduzione: sviluppo di app utilizzando l'API Data Portability

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

Se cerchi informazioni su come gli utenti condividono i dati, consulta l'articolo Condividere una copia dei tuoi dati con una terza parte.

Prerequisiti

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

Devi anche 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 una terza parte".

Flusso di lavoro per sviluppatori

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

I passaggi che uno sviluppatore segue per creare un'app utilizzando l'API Data Portability

  1. Implementa il flusso di consenso OAuth per l'utente. In questo esempio, l'utente fornisce 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 di 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 suoi 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. L'app chiama InitiatePortabilityArchive(resources = ["myactivity.youtube"]) con un token OAuth collegato contenente questo ambito OAuth:

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

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

  3. La tua app chiama GetPortabilityArchiveState(job_id) con un token OAuth associato che contiene 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 è COMPLETO, l'archivio è pronto e vengono forniti gli URL firmati di Cloud Storage. Tieni presente che il tempo necessario per completare la richiesta di archiviazione può variare da alcuni minuti a diverse ore, a seconda delle dimensioni dei dati.

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

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

Per ulteriori informazioni sull'utilizzo dei metodi dell'API Data Portability, consulta Chiamare i metodi dell'API 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.

I passaggi che un utente esegue per esportare i propri dati

  1. Innanzitutto, all'utente viene presentata un'opzione per recuperare i suoi dati.

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

  3. L'utente fa clic su Avanti quando gli viene chiesto di condividere i suoi dati e su Ok quando gli viene chiesto di accettare le Norme sulla privacy.

  4. A questo punto, all'utente viene mostrata una schermata di 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, inizia l'importazione dei dati. A seconda delle dimensioni dei dati, il completamento della richiesta può richiedere da alcuni minuti a diverse ore.