En este documento, se incluye información de autorización y autenticación específica de la API de Google Classroom. Antes de leer este documento, asegúrate de leer la información general de autenticación y 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 otorgado 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 los datos de Google Workspace, incluidos los datos de las Cuentas de Google de los usuarios.
Cuando se instala tu app, se le solicita al usuario que valide los permisos que esta usa. Por lo general, debes elegir el permiso más específico posible y evitar solicitar permisos que tu app no requiera. Los usuarios otorgan acceso con mayor facilidad a alcances limitados y claramente descritos.
La API de Classroom admite los siguientes permisos de acceso:
| Permisos | Significado |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Consulta, crea y actualiza los archivos adjuntos del proyecto de Google Cloud solicitante para transmitir elementos en las clases que impartes en Google Classroom. |
https://www.googleapis.com/auth/classroom.addons.student
|
Consulta y actualiza los archivos adjuntos del proyecto de Google Cloud solicitante para transmitir elementos 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
|
Consultar 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
|
Consultar tus calificaciones y trabajos en Google Classroom |
https://www.googleapis.com/auth/classroom.coursework.students
|
Administra el trabajo del curso y las calificaciones de los estudiantes en las clases de Google Classroom que impartes, y visualiza las calificaciones y el trabajo de las clases que administras. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Visualiza las calificaciones y el trabajo del curso de los estudiantes en las clases que enseñas o administras en Google Classroom. |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Consulta, edita y crea materiales de trabajo en clase en Google Classroom. |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Consulta todos los materiales de trabajo de tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Consultar tus tutores de Google Classroom |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Ver y administrar a los tutores de los estudiantes en tus clasas de Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Consulta los tutores de los estudiantes en tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.profile.emails
|
Consultar las direcciones de correo electrónico de las personas de tus clases |
https://www.googleapis.com/auth/classroom.profile.photos
|
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
|
Administra las listas de tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Ver las listas de tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Ver tus calificaciones y trabajos de 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 impartes o administras. |
https://www.googleapis.com/auth/classroom.topics
|
Consulta, crea y edita temas en Google Classroom. |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Consulta los temas en Google Classroom. |