Method: courses.announcements.getAddOnContext

Obtiene metadatos de los complementos de Classroom en el contexto de una publicación específica.

Para mantener la integridad de su propio modelo de datos y permisos, un complemento debe llamar a esta función para validar los parámetros de consulta y el rol del usuario solicitante cada vez que se abre el complemento en un iframe.

Este método muestra los siguientes códigos de error:

  • PERMISSION_DENIED para errores de acceso.
  • INVALID_ARGUMENT si la solicitud tiene un formato incorrecto.
  • NOT_FOUND si uno de los recursos identificados no existe.

Solicitud HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnContext

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
courseId

string

Obligatorio. Es el identificador del curso.
itemId

string

Es el identificador de Announcement, CourseWork o CourseWorkMaterial en el que se adjunta el archivo. Este campo es obligatorio, pero no se marca como tal mientras migramos desde postId.

Parámetros de consulta

Parámetros
addOnToken

string

Opcional. Es el token que autoriza la solicitud.

El token se pasa como un parámetro de consulta cuando se redirecciona al usuario de 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. Es el identificador del archivo 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.