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 è unjob_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 astart_time
oend_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:
myactivity.search
: https://www.googleapis.com/auth/dataportability.myactivity.searchmyactivity.youtube
: https://www.googleapis.com/auth/dataportability.myactivity.youtube
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 congoogle-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.