- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
Obtiene los metadatos de los complementos de Classroom en el contexto de una publicación específica.
Para mantener la integridad de sus propios datos y modelos de permisos, un complemento debe llamarlo para validar los parámetros de consulta y el rol del usuario que realiza la solicitud cada vez que el complemento se abre en un iframe.
Este método muestra los siguientes códigos de error:
PERMISSION_DENIED
para errores de acceso- Es
INVALID_ARGUMENT
si la solicitud no tiene el formato correcto. NOT_FOUND
si no existe uno de los recursos identificados.
Solicitud HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnContext
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
courseId |
Obligatorio. Es el identificador del curso. |
itemId |
Identificador del anuncio, CourseWork o CourseWorkMaterial en el que se adjunta el archivo adjunto. Este campo es obligatorio, pero no se marcará como tal mientras migramos desde postId. |
Parámetros de consulta
Parámetros | |
---|---|
addOnToken |
Opcional. El token que autoriza la solicitud. El token se pasa como parámetro de consulta cuando se redirecciona al usuario desde Classroom a la URL del complemento. El token de autorización es obligatorio cuando no se cumple ninguna de las siguientes condiciones:
|
attachmentId |
Opcional. El identificador del adjunto. Este campo es obligatorio para todas las solicitudes, excepto cuando el usuario se encuentra en el iframe de descubrimiento de archivos adjuntos. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de AddOnContext
.
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/classroom.addons.student
https://www.googleapis.com/auth/classroom.addons.teacher
Para obtener más información, consulta la Guía de autorización.