Las guías de inicio rápido explican cómo configurar y ejecutar una app que llama a una API de Google Workspace.
En las guías de inicio rápido de Google Workspace, se usan las bibliotecas cliente de la API para manejar algunos detalles del flujo de autenticación y autorización. Te recomendamos que uses las bibliotecas cliente para tus propias apps. En esta guía de inicio rápido, se usa un enfoque de autenticación simplificado que es adecuado para un entorno de pruebas. En el caso de un entorno de producción, te recomendamos que obtengas información sobre la autenticación y la autorización antes de elegir las credenciales de acceso apropiadas para la app.
Crea una aplicación de línea de comandos de Java que realice solicitudes a la API de Google Vault.
Objetivos
- Configurar el entorno
- Configura la muestra.
- Ejecuta la muestra.
Requisitos previos
- Java 1.8 o superior.
- Gradle 7.0 o una versión posterior
- Un proyecto de Google Cloud.
- Una Cuenta de Google
Configura tu entorno
Para completar esta guía de inicio rápido, configura tu entorno.
Habilita la API
Antes de usar las APIs de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más APIs en un solo proyecto de Google Cloud.En la consola de Google Cloud, habilita la API de Google Vault.
Cómo configurar la pantalla de consentimiento de OAuth
Si usas un proyecto de Google Cloud nuevo para completar esta guía de inicio rápido, configura la pantalla de consentimiento de OAuth y agrégate como usuario de prueba. Si ya completaste este paso para tu proyecto de Cloud, pasa a la siguiente sección.
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Pantalla de consentimiento de OAuth.
- En Tipo de usuario, selecciona Interno y, luego, haz clic en Crear.
- Completa el formulario de registro de la app y, luego, haz clic en Save and Continue.
Por ahora, puedes omitir la adición de permisos y hacer clic en Guardar y continuar. En el futuro, cuando crees una app para usarla fuera de tu organización de Google Workspace, deberás cambiar el Tipo de usuario a Externo y, luego, agregar los permisos de autorización que requiera tu app.
- Revisa el resumen del registro de tu app. Para realizar cambios, haz clic en Editar. Si el registro de la app es correcto, haz clic en Volver al panel.
Autoriza las credenciales de una aplicación para computadoras
Para autenticar a los usuarios finales y acceder a los datos del usuario en tu app, debes crear uno o más ID de cliente de OAuth 2.0. Un ID de cliente se usa con el fin de identificar una sola app para los servidores de OAuth de Google. Si la app se ejecuta en varias plataformas, debes crear un ID de cliente diferente para cada una.- En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- Haz clic en Tipo de aplicación > App de escritorio.
- En el campo Nombre, escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
- Haz clic en Crear. Aparecerá la pantalla de creación del cliente de OAuth, en la que se mostrará tu ID de cliente nuevo y el secreto del cliente.
- Haz clic en OK. La credencial creada recientemente aparecerá en IDs de cliente de OAuth 2.0.
- Guarda el archivo JSON descargado como
credentials.json
y muévelo a tu directorio de trabajo.
Prepara el lugar de trabajo
En tu directorio de trabajo, crea una nueva estructura de proyecto:
gradle init --type basic mkdir -p src/main/java src/main/resources
En el directorio
src/main/resources/
, copia el archivocredentials.json
que descargaste antes.Abre el archivo
build.gradle
predeterminado y reemplaza su contenido por el siguiente código:
Configura la muestra
En el directorio
src/main/java/
, crea un archivo Java nuevo con un nombre que coincida con el valormainClassName
en tu archivobuild.gradle
.Incluye el siguiente código en tu nuevo archivo Java:
Ejecutar la muestra
Ejecuta la muestra:
gradle run
-
La primera vez que ejecutes la muestra, se te solicitará que autorices el acceso:
- Si aún no accediste a tu Cuenta de Google, hazlo cuando se te solicite. Si accediste a varias cuentas, selecciona una para usar la autorización.
- Haz clic en Aceptar.
Tu aplicación de Java ejecuta y llama a la API de Google Vault.
La información de autorización se almacena en el sistema de archivos, por lo que la próxima vez que ejecutes el código de muestra, no se te solicitará autorización.
Próximos pasos
- Soluciona problemas de autenticación y autorización
- Documentación de referencia de la API de Vault
- Documentación sobre el cliente de las APIs de Google para Java
- Documentación de Javadoc de la API de Google Vault