简介

Google 课堂中的作业称为 CourseWork 内容，可以在 Google 课堂任意课程的“课业”页面。课程共有四种课业 因此本指南仅重点介绍“作业”类型。如果您想 请阅读我们的 管理课业指南。

Google 课堂可通过以下两种方式与作业工作流程集成： “课堂分享”按钮 和 Classroom API。 使用分享按钮，用户可以将内容作为任意流项目通过 “课堂”弹出式对话框，而 Classroom API 支持从头到尾 分配工作流程，其中包括创建分配、创建和管理 学生提交的作业，以及为回传评分。

下面我们将介绍这两种开发者产品之间的主要区别。 更具体地说，我们将讨论在实施方面 作业生命周期的每个阶段：创建作业、学生 提交和评分/反馈。

了解分配生命周期

在介绍分享按钮和 CourseWork API 之间的区别之前， 我们先在 了解 Google 课堂的相关情况。这将有助于您了解教师和学生 在 Google 课堂中与作业互动。

与 Google 课堂集成时，请牢记五个主要步骤 分配：

1. 已创建分配。
2. 作业已与学生共享。
3. 学生完成作业。
4. 学生向教师提交作业。
5. 教师评价和为作业评分。

与 Google 课堂作业集成后，教师和学生就可以 在 Google 课堂和第三方应用之间无缝切换。您无需管理 作业或学生提交的作业的详细信息，用户可以依赖您的 为他们管理这些详细信息

实现

分享按钮和 CourseWork API 的第一个不同之处在于 实现。从开发者的角度来看，分享按钮更方便 方法将内容共享到 Google 课堂中，因为它只需要包含 添加必要的 JavaScript 资源和添加分享按钮代码。简而言之， 表单，Google 课堂分享按钮集成可能如以下代码段所示：

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

您可以详细了解如何与分享工具集成， 按钮，请点击此处。

另一方面，CourseWork API 是 Google Classroom API REST API 的一部分， 要求通过 Google Cloud 控制台设置和启用 API 密钥， 与 API 集成的最佳做法不太令人担心 如果您的平台已在利用其他 Classroom API 功能，例如 名单生成。

创建与共享作业

虽然分享按钮和 CourseWork API 都能启用 创建作业以及将作业分享给学生， 介绍了您在选择解决方案之前应考虑的一些关键区别。

从本质上讲，这两种解决方案都能够以 Google 课堂中的作业。这是一个强大的工作流程，可帮助教师 否则就不得不进行复制和粘贴工作流程 Google 课堂和第三方应用。虽然这两种解决方案都支持 才能将内容作为作业发布，那么您应该考虑 应用需要灵活地将此内容作为其他课业发布 甚至是通知

这两种产品均提供除测验作业以外的所有 Google 课堂帖子类型。答 下面列出了所有帖子类型的摘要，以及是否显示这些帖子。

帖子类型	“分享”按钮	CourseWork API
作业	X	X
测验作业
问题：简答	X	X
问题：单选题	X	X
材质	X	X
通知	X	X

指定标题和说明等功能也可 由您的应用以编程方式指定。虽然 通过集成分享按钮，用户可以设置截止日期、主题、 个性化模式和点数， 由第三方应用以编程方式设置。而 API 公开所有这些字段，用于读写访问。

分享按钮也不允许您的应用 用于指定特定于问题类型的字段，例如选择题选项。

修改分配

无需用户手动同步其 作业是与 Classroom API 集成的其中一项优势。通过 分享按钮缺少更新或删除分配关系的功能 因此任何必要的修改都必须由用户执行 Google 课堂界面。

借助 CourseWork API，您可以修改和删除作业 还可以检索任何应用的详细信息 发布到用户课程的作业。但请务必注意 不能由同一 Developer Console 创建的 CourseWork 项目 由该开发者控制台修改过的内容此权限模型会扩展到 分配生命周期，例如管理学生提交的作业和成绩， 访问该 CourseWork 项目的权限。

自动同步作业

借助 Pub/Sub推送通知 您的应用可以订阅在出现以下情况时触发事件的通知： 是 CourseWork 内容及相关学生提交的更改。这个 可以让您的应用省去 需要持续检查 Google 课堂中的内容是否已更新。

正在完成和提交作业

每份作业都与 N 位学生提交的作业相关联，其中 N 表示 作业布置给的学生人数。换言之，对于每个 每个学生都有关联的学生提交作业， 可以使用唯一 ID 访问这些学生提交的作业会自动 创建，并且可以由您的应用与学生提交的作业一起检索 GET 和 LIST 端点。

分享按钮和 CourseWork API 都支持将链接或文件添加到 学生提交的作业。用户可通过分享按钮 与教师作业创建对话框类似的工作流程，而 CourseWork 通过 studentSubmissions.modifyAttachments API 输出 端点。但是，由于前面详述的 API 权限限制， 此功能仅适用于您的应用创建的 CourseWork 内容。 这一限制不适用于分享按钮，学生可以添加 对自己在 Google 课堂中选择的任何作业进行编辑。

结束学生工作流程

虽然 CourseWork 权限限制不适用于 不支持创建作业的平台，其一大优势就是 第三方平台可以防止学生同时提交 而忘记上交作业，因为只有共享按钮 使学生无法提交作业。

自 2019 年 11 月起，分享按钮开始提供 指定学生将附件添加到的课程，但 不支持自动选择作业。考虑 提交错误作业的学生。

审核与为作业评分

作业生命周期的最后阶段要返回到教师的名下。一次 有学生已成功上交作业，教师现在可以 您可以采用最合适的方式来复习作业。对于文件 学生可以直接在 Google 课堂评分工具中批改。第三方 但无法在 Google 课堂评分工具中访问这些应用。通过 这意味着，教师必须浏览多个标签页 来为作业评分。

分享按钮目前未提供评分和发回解决方案 分配。虽然目前不支持学生提交评论等功能， 进行评分以及将这些成绩发回给学生 通过 studentSubmissions.patch 和 studentSubmissions.return 端点。只能为 CourseWork 信息流内容指定成绩（作业） 和问题类型）。它们只能以数字形式提供，可以是 布置为草稿成绩或最终成绩。

要发回作业或为作业评分，学生提交的作业必须 必须先上交。目前，“课堂”界面与 和 API 工作。

差异摘要

为了总结前面部分介绍的所有内容，下表显示了 比较了 上述类别：实施、创建和共享分配 完成和提交作业，以及审核作业和为作业评分。

	“分享”按钮	CourseWork API
实现	只有几行 JavaScript，实施过程非常简单， 快速	需要设置 API 密钥、在管理控制台中启用 API，以及完成更近一步的操作 监控
创建和共享作业	将教师重定向到 Google 课堂分享按钮共享对话框 用户可以只发布一种信息流项目类型 可以指定的字段较少 一个账号可用于创建作业，但无法提取或修改作业数据	不需要分享按钮对话框 您可以指定大多数 Google 课堂作业字段 能够修改由您的应用创建的课程作业 允许您的应用从 Google 课堂中提取所有作业数据
完成和提交作业	将学生重定向到 Google 课堂分享按钮共享对话框 允许学生将提交的作业附加到任何 Google 课堂作业中 一个账号支持提交附件，但无法拉取或修改提交数据 不允许学生上交作业	不需要分享按钮对话框 仅允许学生将提交内容附加到应用创建的作业中 允许您的应用修改其创建的学生提交的作业 允许学生上交作业
查看作业并为作业评分	不支持指定或返回成绩	允许您的应用代表教师从 Google 课堂提取所有学生提交的数据 公开为学生分配成绩（草稿或最终成绩）的权限 公开了修改学生成绩的权限 向学生公开发回成绩的功能