Este documento contiene 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 Obtén más información sobre la autenticación y autorización.
Configurar OAuth 2.0 para la autorización
Configura la pantalla de consentimiento de OAuth y elige los alcances para definir qué información se muestra a los usuarios y revisores de apps, y registra tu app para que puedas publicarla más tarde.
Permisos de la API de Classroom
Para definir el nivel de acceso otorgado a tu app, debes identificar y declarar los permisos de autorización. Un alcance de autorización es una string 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 solicita al usuario que valide los permisos que esta usa. En general, debes elegir el alcance más reducido posible y evitar solicitar permisos que la app no requiere. Los usuarios otorgan acceso a permisos limitados y claramente descritos.
La API de Classroom admite los siguientes alcances:
| Permisos | Significado |
|---|---|
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
|
Ver tus clases de Google Classroom |
https://www.googleapis.com/auth/classroom.coursework.me
|
Ver, crear y editar los elementos del trabajo, incluidas las tareas, las preguntas y las calificaciones. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Visualiza tus calificaciones y trabajos de curso en Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.students
|
Administra el trabajo de curso y las calificaciones de los alumnos de las clases de Google Classroom que impartes, y consulta las calificaciones y el trabajo de curso de las clases que administras. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Ver el trabajo de curso y las calificaciones de los alumnos en las clases de Google Classroom que enseñas o administras |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Ver, editar y crear 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
|
Consulta tus tutores de Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Visualiza y administra a los tutores de los alumnos en tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Consulta los tutores de los alumnos en tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.profile.emails
|
Visualiza las direcciones de correo electrónico de las personas de tus clases. |
https://www.googleapis.com/auth/classroom.profile.photos
|
Visualiza 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
|
Ver las listas de tus clases de Google Classroom |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Visualiza tus calificaciones y trabajos de curso en Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Ver el trabajo de curso y las calificaciones de los alumnos en las clases de Google Classroom que enseñas o administras |
https://www.googleapis.com/auth/classroom.topics
|
Ver, crear y editar temas en Google Classroom |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Consulta los temas en Google Classroom. |