资源:课程
Google 课堂中的课程。
JSON 表示法 |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
字段 | |
---|---|
id |
此课程由 Google 课堂分配的标识符。 如果 在课程更新掩码中指定此字段会导致错误。 |
name |
课程的名称。例如,“10 年级生物学”。必须填写名称。长度必须介于 1 到 750 个字符之间,且必须使用有效的 UTF-8 字符串。 |
section |
课程部分。例如,“时间段 2”。设置后,此字段必须是有效的 UTF-8 字符串,且不得超过 2800 个字符。 |
descriptionHeading |
说明的标题(可选)。例如,“欢迎学习 10 年级生物学”。设置后,此字段必须是有效的 UTF-8 字符串,且不得超过 3600 个字符。 |
description |
可选说明。例如,“我们将综合运用教科书、客座讲座和实验工作,了解生物的结构。期待您的到来!”设置后,此字段必须是有效的 UTF-8 字符串,且不得超过 30000 个字符。 |
room |
会议室位置(可选)。例如,"301"。设置后,此字段必须是有效的 UTF-8 字符串,且不得超过 650 个字符。 |
ownerId |
课程所有者的标识符。 指定为
必须在创建请求中设置。管理员也可以在 |
creationTime |
课程的创建时间。在课程更新掩码中指定此字段会导致错误。 只读。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
updateTime |
此课程的最新更新时间。在课程更新掩码中指定此字段会导致错误。 只读。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
enrollmentCode |
加入本课程时使用的注册代码。在课程更新掩码中指定此字段会导致错误。 只读。 |
courseState |
课程状态。如果未指定该属性,则默认状态为 |
alternateLink |
Google 课堂网页界面中课程的绝对链接。 只读。 |
teacherGroupEmail |
包含课程所有教师的 Google 群组的电子邮件地址。此群组不接受电子邮件,只能用于授予权限。 只读。 |
courseGroupEmail |
包含课程所有成员的 Google 群组的电子邮件地址。此群组不接受电子邮件,只能用于授予权限。 只读。 |
teacherFolder |
与课程的所有教师共享的云端硬盘文件夹信息。 只有课程管理员和网域管理员设置此字段。 只读。 |
courseMaterialSets[] |
显示在课程“简介”页面上的一套内容。 只读。 |
guardiansEnabled |
是否为此课程启用监护人通知。 只读。 |
calendarId |
所有课程成员都可以查看的日历的日历 ID,Google 课堂会将此 ID 添加到课程的课程作业和通知中。 当课程首次设置为 只读。 |
gradebookSettings |
成绩册设置用于指定课程的总体成绩计算方式和显示给谁。 只读 |
课程状态
课程可能所处的状态。
枚举 | |
---|---|
COURSE_STATE_UNSPECIFIED |
无课程状态。没有任何返回的课程消息将使用此值。 |
ACTIVE |
此课程处于有效状态。 |
ARCHIVED |
此课程已归档。您不能修改此状态,只能将其更改为其他状态。 |
PROVISIONED |
课程已创建,但尚未激活。主讲教师和网域管理员可以访问该课程,而且可能会修改此课程或将其更改为ACTIVE 或DECLINED 状态。课程只有在处于 DECLINED 状态时才能更改为 PROVISIONED 。 |
DECLINED |
课程已创建,但被拒绝。课程所有者和网域管理员可以访问此信息中心,但其不会显示在网页界面中。您不能修改课程,除非将它更改为 PROVISIONED 状态。课程只有在处于 PROVISIONED 状态时才能更改为 DECLINED 。 |
SUSPENDED |
该课程已暂停。您无法修改课程,只有由 ownerId 标识的用户才能查看课程。如果课程可能违反了《服务条款》,我们可能会处于此状态。 |
课程资料集
显示在课程“简介”页面上的一组资料。这些资料可能包括课程大纲、课程安排或与整个课程相关的其他背景信息。
JSON 表示法 |
---|
{
"title": string,
"materials": [
{
object ( |
字段 | |
---|---|
title |
此组的标题。 |
materials[] |
向这组内容附加了资料。 |
课程资料
作为资料集的一部分附加到课程中的资料。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 material 。Material 数据。material 只能是下列其中一项: |
|
driveFile |
Google 云端硬盘文件附件。 |
youTubeVideo |
YouTube 视频附件。 |
link |
关联。 |
form |
Google 表单附件。 |
成绩册设置
课程的成绩册设置。如需了解详情,请参阅帮助中心文章。
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 |
在成绩册和学生资料中向教师显示总体成绩。对学生的个人资料隐藏。 |
方法 |
|
---|---|
|
创建课程。 |
|
删除课程。 |
|
返回课程。 |
|
返回请求提出者可以查看的课程列表,仅限与该请求匹配的课程。 |
|
更新课程中的一个或多个字段。 |
|
更新课程。 |