Chiama l'API Data Portability utilizzando uno script Python

In questa guida rapida, ottieni un token OAuth per il tuo account e invii richieste agli endpoint dell'API Data Portability utilizzando uno script Python.

Cosa imparerai

In questa guida rapida, utilizzerai uno script Python per:

  • Invia una richiesta autenticata all'endpoint InitiatePortabilityArchive fornendo un token OAuth valido. La risposta è un valore job_id valido.
  • Invia una richiesta autenticata all'endpoint GetPortabilityArchiveState e scarica i dati. La risposta deve contenere uno stato del job valido e, al termine del job, un URL firmato.
  • Invia una richiesta autenticata all'endpoint ResetAuthorization. Questa richiesta revoca tutti gli ambiti OAuth concessi dall'utente.

Prerequisiti

Per eseguire questa guida rapida, devi:

  • Verifica che l'API Data Portability sia disponibile. Per un elenco dei paesi e delle regioni supportati, vedi le Domande comuni nella pagina "Condividere una copia dei tuoi dati con una terza parte".
  • Completa la procedura di configurazione per l'API Data Portability e verifica di utilizzare un nuovo progetto.
  • Ottenere l'accesso a un account di proprietà o controllato dalla tua organizzazione. I dati sull'attività di ricerca di questo account vengono esportati in questa guida rapida.

Prima di iniziare questa guida rapida, devi anche configurare OAuth, Python e il pacchetto OAuth per le librerie client Python.

Configurare OAuth

  • Segui i passaggi per configurare OAuth per le applicazioni installate. Questo flusso è simile al flusso OAuth per le applicazioni server web. Quando configuri l'ID client OAuth:
    • Il Tipo di applicazione deve essere App desktop.
    • Dopo aver creato l'ID client, scarica il client secret in formato JSON e assegna al file il nome client_secrets.json.
    • Quando configuri gli ambiti per l'API Data Portability, tieni presente che questa guida rapida utilizza i seguenti gruppi di risorse:

Configura Python

Per eseguire lo script utilizzato in questa guida rapida, devi configurare Python sulla tua macchina locale. Per configurare Python:

  • Installa lo strumento di gestione dei pacchetti Pip e Python 3.9 o versioni successive.
  • Installa la libreria client dell'API di Google per Python.

  • Installa il pacchetto google_auth_oauthlib per la libreria client Python eseguendo questo comando. Questo pacchetto fornisce l'integrazione oauthlib con google-auth, la libreria di autenticazione di Google per Python.

    pip install google-auth-oauthlib google-api-python-client --upgrade

Esegui lo script

Questo script utilizza un reindirizzamento localhost nel flusso OAuth. Questa opzione richiede che l'applicazione sia in ascolto su una porta localhost, quindi apra il browser di sistema per avviare il flusso di autorizzazione OAuth.

Fai clic su questo link per aprire lo script o scarica una copia dello script facendo clic con il tasto destro del mouse sul link.

Script della guida rapida Python dell'API Data Portability

Per eseguire lo script, inserisci questo comando:

python3 data-portability-quickstart.py

Le azioni eseguite dallo script sono descritte in dettaglio nei commenti.