Los complementos de Google Classroom ya están en fase de disponibilidad general para desarrolladores. Consulta la documentación sobre complementos para obtener más informació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:
Es el identificador de Announcement, 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
postId (deprecated)
string
Opcional. obsoleta: Usa itemId en su lugar.
addOnToken
string
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:
El complemento tiene archivos adjuntos en la publicación.
El proyecto del desarrollador que emite la solicitud es el mismo que creó la publicación.
attachmentId
string
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: