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 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 los 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 permisos de autorización. Un permiso 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 la Cuenta de Google de los usuarios.
Cuando se instala tu app, se le solicita al usuario que valide los permisos que usa la app. 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 más fácilmente a los permisos limitados y claramente descritos.
La API de Classroom admite los siguientes permisos:
| Permisos | Significado |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Permite ver, crear y actualizar los archivos adjuntos del proyecto de Google Cloud solicitante a los elementos de la transmisión en las clases que enseñas en Google Classroom. |
https://www.googleapis.com/auth/classroom.addons.student
|
Permite 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
|
Permite ver y administrar anuncios en Google Classroom. |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Permite ver anuncios en Google Classroom. |
https://www.googleapis.com/auth/classroom.courses
|
Permite ver, editar, crear y borrar de forma permanente tus Google Classroom classes. |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Permite ver tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.me
|
Permite ver, crear y editar los elementos del curso, como tareas, preguntas y calificaciones. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Permite ver tus calificaciones y los trabajos de tu curso en Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.students
|
Permite administrar las calificaciones y trabajos del curso de los estudiantes en las clases de Google Classroom que impartes, y ver las calificaciones y los trabajos de las clases que administras. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Permite ver las calificaciones y los trabajos del curso de los estudiantes en las clases que impartes o administras en Google Classroom. |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Permite consultar, editar y crear materiales de trabajo en clase en Google Classroom. |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Permite consultar todos los materiales de trabajo de tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Permite ver tus tutores de Google Classrom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Permite ver y administrar a los tutores de los estudiantes en tu clase de Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Permite ver los tutores para 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
|
Permite recibir notificaciones sobre tus datos de Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters
|
Permite administrar las listas de tus clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Permite ver los horarios de las clases de Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Permite ver tus calificaciones y los trabajos de tu curso en Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Permite ver las calificaciones y los trabajos del curso de los estudiantes en las clases que impartes o administras en Google Classroom. |
https://www.googleapis.com/auth/classroom.topics
|
Permite consultar, crear y editar los temas en Google Classroom. |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Permite consultar los temas en Google Classroom. |