Este documento contiene información específica sobre la autorización y la autenticación de la API de Google Classroom. Antes de leer este documento, asegúrate de leer la información general sobre la autenticación y la autorización de Google Workspace en Más información sobre la autenticación y la autorización.
Configura OAuth 2.0 para la autorización
Configura la pantalla de consentimiento de OAuth y elige permisos para definir qué información se muestra a los usuarios y revisores de apps, y registra tu app para que puedas publicarla más adelante.
Permisos de la API de Classroom
Para definir el nivel de acceso que se otorga a tu app, debes identificar y declarar los alcances de autorización. Un alcance de autorización es una cadena de URI de OAuth 2.0 que contiene el nombre de la app de Google Workspace, el tipo de datos a los que accede y el nivel de acceso. Los permisos son las solicitudes de tu app para trabajar con datos de Google Workspace, incluidos los datos de las Cuentas de Google de los usuarios.
Cuando se instala tu app, se le pide al usuario que valide los alcances que usa la app. Por lo general, debes elegir el alcance más específico posible y evitar solicitar alcances que tu app no necesite. Los usuarios otorgan acceso más fácilmente a los permisos limitados y claramente descritos.
La API de Classroom admite los siguientes alcances:
| Permisos | Significado |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Ver, crear y actualizar los archivos adjuntos del proyecto de Google Cloud solicitante a los elementos de transmisión en las clases que enseñas en Google Classroom |
https://www.googleapis.com/auth/classroom.addons.student
|
Ver y actualizar los archivos adjuntos del proyecto de Google Cloud solicitante a los elementos de la transmisión en Google Classroom |
https://www.googleapis.com/auth/classroom.announcements
|
Ver y administrar anuncios en Google Classroom |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Ver anuncios en Google Classroom |
https://www.googleapis.com/auth/classroom.courses
|
Ver, editar, crear y borrar de forma permanente tus clases de Google Classroom |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Permite ver tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.me
|
Ver, crear y editar los elementos del curso, como tareas, preguntas y calificaciones |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Ver tus calificaciones y los trabajos de tu curso en Google Classroom |
https://www.googleapis.com/auth/classroom.coursework.students
|
Administrar las calificaciones y trabajos del curso de los estudiantes en las clases de Google Classroom que imparte, y ver las calificaciones y los trabajos de las clases que administra |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Ver las calificaciones y los trabajos del curso de los estudiantes en las clases de Google Classroom que enseñas o administras |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Consultar, editar y crear materiales de trabajo en clase en Google Classroom |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Consultar todos los materiales de trabajo de tus clases de Google Classroom |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Observa tus tutores de Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Ver y administrar a los tutores de los estudiantes en tus clases de Google Classroom |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Observa los tutores de los estudiantes en tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.profile.emails
|
Permite ver las direcciones de correo electrónico de las personas de tus clases. |
https://www.googleapis.com/auth/classroom.profile.photos
|
Permite ver las fotos de perfil de las personas de tus clases. |
https://www.googleapis.com/auth/classroom.push-notifications
|
Recibir notificaciones sobre tus datos de Google Classroom |
https://www.googleapis.com/auth/classroom.rosters
|
Administrar las listas de tus clases de Google Classroom |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Permite ver las listas de tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Ver tus calificaciones y los trabajos de tu curso en Google Classroom |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Ver las calificaciones y los trabajos del curso de los estudiantes en las clases de Google Classroom que enseñas o administras |
https://www.googleapis.com/auth/classroom.topics
|
Consultar, crear y editar temas en Google Classroom |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Consultar los temas en Google Classroom |