资源:课程
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 字符串,且长度不得超过 30,000 个字符。 |
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 课堂会添加课程作业和课程通知的活动。 只读。 |
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 |
在成绩册和学生个人资料中向教师显示总体成绩。在学生的个人资料中隐藏学生。 |
方法 |
|
---|---|
|
创建课程。 |
|
删除课程。 |
|
返回课程。 |
|
返回请求用户有权查看的课程列表,仅限与该请求匹配的课程。 |
|
更新课程中的一个或多个字段。 |
|
更新课程。 |