En las guías de inicio rápido, se explica cómo configurar y ejecutar una app que llama a una API de Google Workspace.
Las guías de inicio rápido de Google Workspace usan las bibliotecas cliente de API para manejar algunos detalles del flujo de autenticación y autorización. Te recomendamos que uses las bibliotecas cliente para tus propias apps. Antes de ejecutar la app de muestra, cada guía de inicio rápido requiere que actives la autenticación y la autorización. Si no estás familiarizado con la autenticación y la autorización para las API de Google Workspace, consulta la descripción general de autenticación y autorización.
Crea una aplicación de línea de comandos de Go que realice solicitudes a la API de Google Classroom.
Objetivos
- Configurar el entorno
- Configura la muestra.
- Ejecuta la muestra.
Requisitos previos
- La versión más reciente de Go.
- La versión más reciente de Git
- Un proyecto de Google Cloud.
- Una cuenta de Google for Education con Google Classroom habilitado
Configure su entorno
Para completar esta guía de inicio rápido, configura tu entorno.
Cómo habilitar la API
Antes de usar las API de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más API en un solo proyecto de Google Cloud.En Google Cloud Console, habilita la API de Google Classroom.
Autoriza credenciales para una aplicación de escritorio
Para autenticarte como usuario final y acceder a los datos del usuario en tu app, debes crear uno o más ID de cliente de OAuth 2.0. Se usa un ID de cliente para identificar una sola app en los servidores de OAuth de Google. Si tu app se ejecuta en varias plataformas, debes crear un ID de cliente por separado para cada plataforma.- En la consola de Google Cloud, ve a Menú > API y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- Haz clic en Tipo de aplicación > Aplicación de escritorio.
- En el campo Nombre, escribe un nombre para la credencial. Este nombre solo se muestra en Google Cloud Console.
- Haz clic en Crear. Aparecerá la pantalla del cliente OAuth que muestra tu nuevo ID de cliente y secreto de cliente.
- Haz clic en OK. La credencial creada recientemente se muestra en ID de cliente OAuth 2.0.
- Guarda el archivo JSON descargado como
credentials.json
y muévelo al directorio de trabajo.
Prepare el lugar de trabajo
Cree un directorio de trabajo:
mkdir quickstart
Cambia al directorio de trabajo:
cd quickstart
Inicializa el módulo nuevo:
go mod init quickstart
Obtén la biblioteca cliente de Go para la API de Google Classroom y el paquete de OAuth2:
go get google.golang.org/api/classroom/v1 go get golang.org/x/oauth2/google
Configura la muestra
En tu directorio de trabajo, crea un archivo llamado
quickstart.go
.En el archivo, pega el siguiente código:
Ejecutar la muestra
En tu directorio de trabajo, compila y ejecuta la muestra:
go run quickstart.go
En el navegador, ve a
http://localhost:8000
.La primera vez que ejecutes la muestra, se te pedirá que autorices el acceso:
- Si aún no accediste a tu Cuenta de Google, se te solicitará que lo hagas. Si accediste a varias cuentas, selecciona una para usar en la autorización.
- Haz clic en Aceptar.
- Copia el código del navegador, pégalo en la ventana de la línea de comandos y presiona
Enter
.
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.
Creaste correctamente tu primera aplicación de Go que realiza solicitudes a la API de Google Classroom.
Próximos pasos
- Soluciona problemas de autenticación y autorización
- Documentación de referencia de la API de Classroom
- Sección
google-api-go-client
de GitHub