Google Classroom API 提供了一个编程接口，供软件开发者、管理员和校领导管理 Google 课堂资源。您可以构建用于创建、检索和修改 Google 课堂课程及其内容的软件。
一些典型用例包括：
- 管理课程、学生名单和监护人
- 添加作业、通知和课程资料
- 分配成绩和修改评分设置
- 生成数据以供分析
- 在 Google 课堂中公开外部提供商的内容或工具，以便用户发现和访问
Classroom API 是否适合我？
Google 提供了多款产品来帮助您与 Google 课堂互动。以下是一些常见场景以及可能最适合您需求的产品建议。
修改 Google 课堂资源
| 场景 | 推荐的解决方案 |
|---|---|
| 我想定期管理大量课程、用户或其他 Google 课堂资源。我擅长编写代码和维护软件基础架构。 | 编写使用 Google 课堂 API 的应用。 |
| 我想偶尔管理少量 Google 课堂资源。我可以轻松编写少量代码，并且开销很小。 | 将 Classroom API 与 Google Apps 脚本搭配使用。 |
| 我希望不时更改 Google 课堂中的个别资源。我熟悉使用终端命令。 | 使用 Google Apps Manager。 |
| 我想要大量报告，其中包含 Google 课堂中事件的详细信息。 | 使用 BigQuery Data Transfer Service。 |
| 我想调查用户的活动。 | 在管理控制台中生成报告，或使用报告 API。 |
与 Google 课堂集成
| 场景 | 推荐的解决方案 |
|---|---|
| 我希望教师和学生能够在 Google 课堂中查看和启动我的资源。 | 构建 Google 课堂插件。 |
| 我想让教师点击我网站或应用上的某个按钮，以便将我的内容嵌入 Google 课堂。 | 构建 Google 课堂插件，并以编程方式创建附件。 |
| 我想让教师点击我网站或应用上的按钮，即可在 Google 课堂中访问我的资源。 | 使用 Google 课堂 API 创建课业或嵌入分享到课堂按钮。 |
| 我想让 Google 课堂教师与我的学生信息系统同步或导入信息。 | 实现 OneRoster for SIS，或使用 Classroom API 创建和访问资源。 |
使用入门
我们建议新开发者在开始新项目之前完成以下操作：
- 请参阅我们的 Classroom API 结构指南。
- 不妨了解成绩、用户类型、用户资格条件和管理员操作。这些指南介绍了 Google Classroom 和 Classroom API 特有的概念。
- 了解 Classroom API 请求的运作方式。
如需开始开发，请确保您已完成前提步骤。根据您的需求选择适当的 Google 课堂 API 权限范围，然后按照以下任一快速入门指南设置环境并开始发出请求：
使用 Google APIs Explorer 开展实验
如需对实时数据调用方法进行实验，请尝试使用 Google API Explorer。您无需编写任何代码即可开始使用，但请注意，您使用 API Explorer 执行的操作可能会修改现有数据。
开始调用方法的一种方法是调用 courses.list() 方法。此方法不需要任何请求参数，您可以从返回的课程列表中检索 id，以用作其他 API 调用的请求参数。如果您没有任何课程，可以使用 courses.create() 方法创建课程。
您还可以浏览 Classroom API 参考文档。