Llama a la API de Data Portability con una secuencia de comandos de Python

En esta guía de inicio rápido, obtienes un token de OAuth para tu cuenta y envías solicitudes a los extremos de la API de portabilidad de datos mediante una secuencia de comandos de Python.

Aprendizajes esperados

En esta guía de inicio rápido, usarás una secuencia de comandos de Python para realizar las siguientes tareas:

  • Para enviar una solicitud autenticada al extremo InitiatePortabilityArchive, proporciona un token de OAuth válido. La respuesta es un job_id válido.
  • Envía una solicitud autenticada al extremo GetPortabilityArchiveState y descarga los datos. La respuesta debe contener un estado del trabajo válido y, cuando el trabajo esté completo, una URL firmada.
  • Envía una solicitud autenticada al extremo ResetAuthorization. Esta solicitud revoca todos los permisos de OAuth otorgados por el usuario.

Requisitos previos

Sigue estos pasos para ejecutar esta guía de inicio rápido:

  • Verifica que la API de portabilidad de datos esté disponible para ti. Para obtener una lista de los países y las regiones admitidos, consulta las Preguntas frecuentes en la página "Comparte una copia de tus datos con un tercero".
  • Completa los pasos de configuración de la API de portabilidad de datos y verifica que uses un proyecto nuevo.
  • Obtener acceso a una cuenta que pertenece a su organización o está bajo su control En esta guía de inicio rápido, se exportan los datos de la actividad de búsqueda de esta cuenta.

Antes de comenzar con esta guía de inicio rápido, también debes configurar OAuth, Python y el paquete de OAuth para las bibliotecas cliente de Python.

Configura OAuth

  • Sigue los pasos para configurar OAuth en las aplicaciones instaladas. Este flujo es similar al de OAuth para aplicaciones de servidor web. Cuando configures tu ID de cliente de OAuth, sucederá lo siguiente:
    • El Tipo de aplicación debería ser App de escritorio.
    • Después de crear el ID de cliente, descarga el secreto de cliente en formato JSON y asígnale un nombre al archivo: client_secrets.json.
    • Cuando configures los permisos de la API de portabilidad de datos, ten en cuenta que en esta guía de inicio rápido se usan estos grupos de recursos:

Configura Python

Debes configurar Python en tu máquina local para ejecutar la secuencia de comandos que se usa en esta guía de inicio rápido. Para configurar Python, haz lo siguiente:

  • Instala la herramienta de administración de paquetes Pip y Python 3.9 (o una versión posterior).
  • Instala la biblioteca cliente de la API de Google para Python

  • Instala el paquete google_auth_oauthlib para la biblioteca cliente de Python mediante la ejecución de este comando. Este paquete proporciona integración oauthlib con google-auth, la biblioteca de autenticación de Google para Python.

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

Ejecuta la secuencia de comandos:

Esta secuencia de comandos usa un redireccionamiento de localhost en el flujo de OAuth. Esta opción requiere que la aplicación escuche en un puerto localhost y, luego, abra el navegador del sistema para iniciar el flujo de autorización de OAuth.

Haz clic en este vínculo para abrir la secuencia de comandos, o bien haz clic con el botón derecho en el vínculo para descargar una copia de la secuencia.

Secuencia de comandos de inicio rápido de la API de Data Portability para Python

Para ejecutar la secuencia de comandos, ingresa este comando:

python3 data-portability-quickstart.py

Las acciones que realizó la secuencia de comandos se detallan en los comentarios.