常见问题解答

在 Google 课堂中查看、创建和修改 CourseWork

我可以使用 Classroom API 中的 CourseWork 端点构建哪些内容?

通过新端点,开发者可以查看和管理类中的工作。具体而言, 您可以执行下列所有操作:

  • 查看作业和题目(统称为 CourseWork) 针对用户
  • 创建、修改和删除CourseWork
  • 将资料(云端硬盘文件、YouTube 视频、链接)附加到 CourseWork
  • 更改学生提交作业的状态(例如上交、发回、 回收)
  • 设置提交的作业的成绩
  • 将资料(云端硬盘文件、YouTube 视频、链接)附加到 学生提交的作业

CourseWork 的一些用例示例:

  • 成绩册、学生信息系统或报告系统可从以下位置同步作业和成绩: 将 Google 课堂应用于他们的应用,省去手动数据的麻烦 传输
  • 学习应用可以创建新作业,这些作业会显示在课程中 。学生完成作业后,应用可上交作业、 给学生评分,附加学生的作业,并将作业存储在适当位置 云端硬盘文件夹。
  • 教师用户可以通过您的 网站或应用
  • 学生用户可以上交包含您插件的作业 附件。

我的应用需要哪些权限才能创建或修改分配?

通常,应用只能修改自己创建的工作。也就是说, 任何分配变更 API 请求都必须使用与 是在创建作业时存储的。

Google 课堂插件不受此规则限制。答 Cloud 项目可以访问或修改任何通知、作业或 具有一个或多个插件附件的材料。答 Cloud 项目还可以上交、收回或发回符合以下条件的作业: 具有一个或多个插件附件。

API 请求还需要正确的用户范围。教师可以查看 创建作业、在提交的作业中附加链接,并设置 提交成绩。学生可以查看作业、附加指向自己作业的链接 以及上交和收回学生提交的作业。域名 管理员可以查看 CourseWork,但没有写入权限。

我的申请可以附加哪些类型的作业或提交内容?

该 API 支持附加云端硬盘文件、YouTube 视频以及 链接。尚不支持附加原生 Google 表单。

最终用户是否知道 Google 课堂中的作业是由我的应用创建的?

可以。Google 课堂界面可识别外部创建的作业 使用创建工作的 Google Cloud 项目的产品名称。用户可以 将外部创建的工作报告为不需要的工作,并 创建作品的应用程序,方法是撤销发给 由用户开发应用

课堂分享按钮和其他集成

我已与 Google 课堂分享按钮集成。我可以修改使用分享按钮创建的作业吗?

目前还不支持。如需修改分配,请求必须使用同一个 Google Cloud 项目。

我可以回答 API 中的问题吗?

目前还不支持。您可以创建和修改问题。回答问题 程序化技术已纳入发展路线图。

课堂插件

项目配置

我可以将开发期间使用的专用 Google Cloud 项目转换为可在生产环境中使用的公开项目吗?

您无法将专用 Google Cloud 项目转换为公共项目。您需要两个 不同的项目,一个用于开发,另一个用于生产。

一个 Google Cloud 项目可以有两条 Google Workspace Marketplace 产品详情吗?

不可以。您无法为 单个 Google Cloud 项目

不过,您可以捆绑插件。如此一来 代表多个插件的 Google Workspace Marketplace 产品详情。正在安装 之后会安装此软件包中的所有插件,网址为: 一次。用户需要同意捆绑插件所需的所有范围 。

是否可以通过 Google Cloud 项目将其他 Google Cloud 项目中的 OAuth 客户端重复用于 Google 课堂插件?

否,不是来自 Google Cloud 项目的 OAuth 客户端, 课堂插件 Google Cloud 项目无法运行。访问令牌 由其他 Google Cloud 项目生成的课堂 API 会被拒绝。 您必须为插件项目创建单独的 OAuth 客户端。

用户体验

我们的徽标在小正方形内不能很好地适应,对于 iframe 标题栏中的徽标,有哪些尺寸选项可供选择?

iframe 标题栏仅支持 32x32 方形徽标。这个 根据公司在其网站上使用的网站图标形状 我们指导大家在空间中使用同一徽标,以实现品牌一致性。

网域

同一网域中的所有教师和学生都可以使用已安装的插件吗?

学校管理员可以控制哪些教师可以查看 已安装的插件。只有用户可以使用 Google 课堂插件 以及学习版或教育 Plus 版许可。

网域管理员如何与插件互动?

网域管理员负责控制哪些人可以使用您的插件。他们可以 使用管理员安装方法为整个域安装插件 选项。请注意,如果插件可以单独安装, 管理员可维护插件许可名单;教师可以安装插件 其他成员管理员还可以选择 出于测试目的单独安装您的插件。

管理员可能也会对与您的 Google 员工相关的使用情况统计信息 插件。如果您的产品支持,请考虑提供插件使用情况统计信息 查看您自己的网站

API

以下哪种方法可以可靠地判断合作伙伴页面是在 iframe 还是弹出标签页内加载的?

目前还没有方法可以区分这两者。

哪些可分配的作业内容会获取“学生的作业”评价 iframe?

系统仅为活动类型的附件提供“学生作业回顾”iframe。 调用 courses.courseWork.getAddOnContext 方法可查看帖子是否 类型支持学生的作业。supportsStudentWork 字段只能是 true

插件附件是否可以访问附加的流内容?

可以。您可以getpatch任意AnnouncementCourseWorkCourseWorkMaterial(包含至少一个插件附件)。 您可以对 CourseWork StudentSubmission 执行 reclaimreturnturnIn 操作。

单点登录

可以,他们仍然可以使用 Google 登录功能。

每位学生是否都有格式正确的电子邮件地址(即使他们无法访问 Gmail )?

每位 Google Workspace 教育版用户都有 Google 身份,无论他们身在何处。 确定他们是否有权访问 Gmail。身份由电子邮件表示 地址。对任何特定 Google 服务(包括 Gmail)的身份和访问权限 不同。因此,即使 Gmail 已停用,学生用户仍可使用以下账号登录: 电子邮件地址。

要让学生登录应用,学校管理员是否需要预先批准该应用?

网域管理员必须先将插件列入许可名单,然后才能安装该插件。 (可选)网域管理员可以为此网域中的所有用户安装插件, 网域或组织部门

反馈和常规问题

如何提交功能请求或问题?

您可以在我们的公开问题中提交和查看功能请求,以及对功能请求进行投票 跟踪器

如何知道 Classroom API 中的新功能何时可用?

我们会在版本说明页面(我们的开发者论坛)上发布对该 API 的更新。 和公开问题跟踪器

我在使用 Classroom API。如何询问技术问题?

使用 google-classroom 标签在 Stack Overflow 上发布您的问题。