cba85/google-classroom-cli

一个用于使用 Google Classroom API 的 PHP CLI 工具。

1.0.0 2021-02-16 09:35 UTC

This package is auto-updated.

Last update: 2024-09-18 15:11:21 UTC


README

一个用于使用 Google Classroom API 的 CLI 工具。

从 Google Classroom 获取课程、学生、作业和学生提交的 URL。

为什么?

我想使用 Google Classroom 来管理我的课程(学生和作业)。我希望获取学生为每个作业提交的 URL(包含 Github 仓库),以便自动检索他们的项目。

因此,这个项目只使用 Google Classroom 只读 API 权限,并且只提供一些对我有用的 API 资源。

要求

Composer

确保已全局安装 Composer

安装

$ composer global require cba85/google-classroom-cli

然后确保您的 PATH 中包含全局 Composer 二进制目录。

此目录取决于平台,有关详细信息,请参阅 Composer 文档

更新

$ composer global update cba85/google-classroom-cli

Google Classroom API 设置

  1. 在 Google 开发者控制台创建应用和网页客户端身份验证
  2. 下载 credentials.json 文件并将其移动到应用的 auth/ 文件夹。

如果您将应用作为全局命令使用,请将 credentials.json 文件移动到 ~/.composer/vendor/cba85/google-classroom-cli/auth/ 文件夹。

  1. 首次启动应用程序时,您需要通过 Google OAuth2 服务器授予 Google 应用程序的访问权限以获取访问令牌。然后,将验证码输入到 CLI 提示符中。您的访问令牌将保存在 auth/token.json 文件中。

用法

$ gclass list-courses
$ gclass list-students courseId
$ gclass list-assignments courseId
$ gclass list-submissions courseId assignmentId
$ gclass list-submitted-urls courseId assignmentId

注意

  • list-submitted-urls 命令将在 "course work" 类型为 "assignment" 时列出所有学生提交的 URL。如果 "course work" 类型是 "short answer question",则将检索答案并期望它是一个 URL。

依赖项

文档