- Ресурс: Курс
- КурсСтат
- КурсМатериалНабор
- КурсМатериал
- Настройки журнала успеваемости
- Тип расчета
- Настройка дисплея
- Методы
Ресурс: Курс
Курс в классе.
JSON-представление |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
Поля | |
---|---|
id | Идентификатор этого курса, присвоенный Классом. При Указание этого поля в маске обновления курса приводит к ошибке. |
name | Название курса. Например, «Биология 10 класса». Требуется имя. Оно должно содержать от 1 до 750 символов и быть допустимой строкой UTF-8. |
section | Раздел курса. Например, «Период 2». Если установлено, это поле должно быть допустимой строкой UTF-8 и не длиннее 2800 символов. |
descriptionHeading | Необязательный заголовок описания. Например, «Добро пожаловать в 10-й класс по биологии». Если установлено, это поле должно быть допустимой строкой UTF-8 и не длиннее 3600 символов. |
description | Необязательное описание. Например: «Мы будем изучать строение живых существ, изучая учебники, гостевые лекции и лабораторные работы. Будьте готовы к восторгу!» Если установлено, это поле должно быть допустимой строкой UTF-8 и не длиннее 30 000 символов. |
room | Дополнительное расположение комнаты. Например, «301». Если установлено, это поле должно быть допустимой строкой UTF-8 и не длиннее 650 символов. |
ownerId | Идентификатор владельца курса. Если это поле указано в качестве параметра
Это должно быть установлено в запросе на создание. Администраторы также могут указать это поле в |
creationTime | Время создания курса. Указание этого поля в маске обновления курса приводит к ошибке. Только для чтения. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
updateTime | Время последнего обновления этого курса. Указание этого поля в маске обновления курса приводит к ошибке. Только для чтения. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
enrollmentCode | Код регистрации, который можно использовать при присоединении к этому курсу. Указание этого поля в маске обновления курса приводит к ошибке. Только для чтения. |
courseState | Состояние курса. Если не указано, состояние по умолчанию — |
alternateLink | Полная ссылка на этот курс в веб-интерфейсе Класса. Только для чтения. |
teacherGroupEmail | Адрес электронной почты группы Google, в которую входят все преподаватели курса. Эта группа не принимает электронную почту и может использоваться только для получения разрешений. Только для чтения. |
courseGroupEmail | Адрес электронной почты группы Google, в которую входят все участники курса. Эта группа не принимает электронную почту и может использоваться только для получения разрешений. Только для чтения. |
teacherFolder | Информация о папке на Диске, которая доступна всем преподавателям курса. Это поле будет установлено только для преподавателей курса и администраторов домена. Только для чтения. |
courseMaterialSets[] | Наборы материалов, которые появляются на странице «О курсе» этого курса. Только для чтения. |
guardiansEnabled | Включены ли уведомления опекунов для этого курса. Только для чтения. |
calendarId | Идентификатор календаря, доступный всем участникам курса, в который Класс добавляет события для курсовой работы и объявления в курсе. Календарь курса создается асинхронно, когда для курса впервые устанавливается Только для чтения. |
gradebookSettings | Настройки журнала оценок, определяющие, как будет рассчитываться общая оценка учащегося за курс и кому она будет отображаться. Только чтение |
КурсСтат
Возможные состояния, в которых может находиться курс.
Перечисления | |
---|---|
COURSE_STATE_UNSPECIFIED | Нет конечного состояния. Ни одно возвращаемое сообщение курса не будет использовать это значение. |
ACTIVE | Курс активный. |
ARCHIVED | Курс отправлен в архив. Вы не можете изменить его, кроме как перевести его в другое состояние. |
PROVISIONED | Курс создан, но еще не активирован. Он доступен основному учителю и администраторам домена, которые могут изменить его или перевести в состояние ACTIVE или DECLINED . Курс можно изменить на PROVISIONED только в том случае, если он находится в состоянии DECLINED . |
DECLINED | Курс создан, но отклонен. Он доступен владельцу курса и администраторам домена, но не будет отображаться в веб-интерфейсе. Вы не можете изменить курс, кроме как перевести его в состояние PROVISIONED . Курс может быть изменен на DECLINED только если он находится в состоянии PROVISIONED . |
SUSPENDED | Курс приостановлен. Вы не можете изменить курс, и только пользователь, определенный по идентификатору ownerId может просматривать курс. Курс может быть переведен в это состояние, если он потенциально нарушает Условия обслуживания. |
КурсМатериалНабор
Набор материалов, который отображается на странице «О курсе» курса. Эти материалы могут включать учебную программу, расписание или другую справочную информацию, касающуюся курса в целом.
JSON-представление |
---|
{
"title": string,
"materials": [
{
object ( |
Поля | |
---|---|
title | Название этого набора. |
materials[] | Материалы прилагаются к этому набору. |
КурсМатериал
Материал, прикрепленный к курсу как часть набора материалов.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
Полевой material Союза. Данные о материале. material может быть только одним из следующих: | |
driveFile | Вложенный файл Google Диска. |
youTubeVideo | Вложение видео с Ютуба. |
link | Прикрепление ссылки. |
form | Приложение Google Forms. |
Настройки журнала успеваемости
Настройки журнала оценок для курса. Подробности смотрите в статье Справочного центра .
JSON-представление |
---|
{ "calculationType": enum ( |
Поля | |
---|---|
calculationType | Указывает, как рассчитывается общая оценка. |
displaySetting | Указывает, кто может видеть общую оценку. |
gradeCategories[] | Категории оценок, доступные для курсовой работы в рамках курса. |
Тип расчета
Возможные методы расчета общей оценки.
Перечисления | |
---|---|
CALCULATION_TYPE_UNSPECIFIED | Не указан метод. Это никогда не возвращается. |
TOTAL_POINTS | Общая оценка представляет собой сумму оценок, разделенную на сумму общих баллов независимо от категории. |
WEIGHTED_CATEGORIES | Общая оценка представляет собой средневзвешенное значение по категориям. |
Настройка дисплея
Возможные настройки отображения общей оценки.
Перечисления | |
---|---|
DISPLAY_SETTING_UNSPECIFIED | Настройка не указана. Это никогда не возвращается. |
SHOW_OVERALL_GRADE | Показывает общую оценку в журнале оценок и профиле учащегося как учителям, так и учащимся. |
HIDE_OVERALL_GRADE | Не показывает общую оценку в журнале оценок или профиле учащегося. |
SHOW_TEACHERS_ONLY | Показывает общую оценку учителям в журнале оценок и профиле учащегося. Скрывается от учащихся в их профилях. |
Методы | |
---|---|
| Возвращает, имеет ли пользователь право создавать дополнительные вложения в данном курсе. |
| Возвращает, имеет ли пользователь право обновлять GradingPeriodSettings в данном курсе. |
| Создает курс. |
| Удаляет курс. |
| Возвращает курс. |
| Возвращает настройки оценочного периода в курсе. |
| Возвращает список курсов, которые разрешено просматривать запрашивающему пользователю, ограниченный теми, которые соответствуют запросу. |
| Обновляет одно или несколько полей в курсе. |
| Обновляет курс. |
| Обновляет настройки оценивания курса. |