Получает метаданные для надстроек Класса в контексте определенного сообщения.
Чтобы поддерживать целостность своей собственной модели данных и разрешений, надстройка должна вызывать это для проверки параметров запроса и роли запрашивающего пользователя всякий раз, когда надстройка открывается в iframe .
Этот метод возвращает следующие коды ошибок:
-
PERMISSION_DENIED
для ошибок доступа . -
INVALID_ARGUMENT
если запрос имеет неправильный формат. -
NOT_FOUND
если один из идентифицированных ресурсов не существует.
HTTP-запрос
GET https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnContext
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
courseId | Необходимый. Идентификатор курса. |
postId | Необязательный. Устарело, вместо этого используйте |
Параметры запроса
Параметры | |
---|---|
itemId | Идентификатор |
addOnToken | Необязательный. Токен, авторизующий запрос. Токен передается в качестве параметра запроса, когда пользователь перенаправляется из Класса на URL-адрес надстройки. Токен авторизации необходим, если не выполняется ни одно из следующих условий:
|
attachmentId | Необязательный. Идентификатор вложения. Это поле является обязательным для всех запросов, за исключением случаев, когда пользователь находится в iframe обнаружения вложений . |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит экземпляр AddOnContext
.
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/classroom.addons.student
-
https://www.googleapis.com/auth/classroom.addons.teacher
Дополнительную информацию см. в руководстве по авторизации .