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 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.
  • Memorizza il token OAuth con accesso basato sul tempo per riutilizzarlo in un secondo momento.
  • Invia una richiesta autenticata all'endpoint ResetAuthorization. Questa richiesta revoca tutti gli ambiti OAuth concessi dall'utente.
  • Invia una richiesta autenticata all'endpoint InitiatePortabilityArchive fornendo un token OAuth valido insieme a start_time o end_time per applicare un filtro temporale alla richiesta.

Prerequisiti

Per eseguire questa guida rapida, devi:

  • Verifica che l'API Data Portability sia disponibile. Per un elenco di paesi e regioni supportati, consulta le Domande frequenti nella pagina "Condividere una copia dei tuoi dati con una terza parte".
  • Completa i passaggi 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 delle attività di ricerca di questo account vengono esportati in questa guida introduttiva.

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 il tuo ID client OAuth:
    • Il Tipo di applicazione deve essere App desktop.
    • Dopo aver creato l'ID client, scarica il segreto client 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:

Configurare Python

Per eseguire lo script utilizzato in questo inizio rapido, devi configurare Python sulla tua macchina locale. Per configurare Python:

  • Installa lo strumento di gestione dei pacchetti Pip e Python 3.11 (o versioni successive).
  • Installa la libreria client delle API di Google per Python.
  • Installa il pacchetto google_auth_oauthlib per la libreria client Python eseguendo questo comando. Questo pacchetto fornisce l'integrazione di 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 a localhost nel flusso OAuth. Questa opzione richiede che l'applicazione ascolti su una porta localhost e poi apra il browser di sistema per avviare il flusso di autorizzazione OAuth.

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

Script di avvio rapido dell'API Data Portability in Python

Per eseguire lo script ed esportare il corpus di dati completo, inserisci questo comando:

python3 data-portability-quickstart.py

Per utilizzare ambiti diversi, specificali utilizzando --resources, ad esempio:

python3 data-portability-quickstart.py --resources myactivity.shopping myactivity.play

Per applicare il filtro dei tempi, utilizza lo stesso script con i flag start_time e end_time. Ad esempio:

python3 data-portability-quickstart.py --start_time 2023-01-01T12:00:00Z --end_time 2024-01-01T12:00:00Z

Le azioni intraprese dallo script sono descritte nei commenti.