Method: courses.posts.getAddOnContext

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}/posts/{postId}/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.

postId
(deprecated)

string

Opcional. obsoleta: Usa itemId en su lugar.

Parámetros de consulta

Parámetros
itemId

string

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.

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:

  • 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.