gogcli 实战使用gog classroom submissions get在终端中查询学生提交详情【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli本文是 gogcliGoogle Workspace in your terminalClassroom 命令族的实战指南聚焦于gog classroom submissions get这一只读查询命令它通过 Google Classroom API 按课程、作业与提交标识获取单个学生提交Student Submission的完整状态包括提交状态state、是否迟交late、草稿成绩与已评定成绩draft/assigned grade等核心字段。读完本文你将掌握该命令的完整语法、输出格式、常用 Flag 用法并能结合源码理解其底层实现与常见错误处理策略从而在脚本或自动化工作流中可靠地查询提交状态。命令定位Classroom 命令族中的只读查询入口gog classroom submissions get位于 gogcli 的 classroom 子命令体系中。在命令族定义中ClassroomCmd聚合了 courses、coursework、submissions、announcements 等十余个功能域其中ClassroomSubmissionsCmd统一管理学生提交相关操作list别名ls列出学生提交参考文档get别名info、show获取单个学生提交即本文主题turn-in别名turnin交卷reclaim别名undo撤回提交return别名send返回提交grade别名set、edit设置草稿/已评定成绩从源码角度看get只调用 Google Classroom API 的StudentSubmissions.Get方法只读操作因此它天然适合与--readonly这类安全 Flag 组合使用是巡检提交状态、编写脚本的理想入口。其兄弟命令的文档与定位详见 gog classroom submissions 总览。使用语法与位置参数命令的基本语法如下括号内为可选别名尖括号内为必填位置参数gog classroom (class) submissions (submission) get (info,show) courseId courseworkId submissionId三个位置参数缺一不可其含义为参数含义说明courseId课程 ID课程标识符或别名来自gog classroom courses listcourseworkId作业 ID该课程下的作业CourseWork标识符submissionId提交 ID学生提交StudentSubmission标识符在实际运行前命令会先做参数校验在 ClassroomSubmissionsGetCmd.Run 的实现 中三个参数都会先经strings.TrimSpace去空白任何一个为空都会返回usage错误如empty courseId、empty courseworkId、empty submissionId避免带着空参数发起无意义的 API 请求。如何拿到这三个 ID通常的工作流是先用列表命令找到目标# 1. 查看课程 gog classroom courses list # 2. 查看某课程下的作业 gog classroom coursework list courseId # 3. 查看某作业下的所有提交含 submissionId gog classroom submissions list courseId courseworkId列表命令支持--state、--user、--late、--max等过滤条件详见 gog classroom submissions list 文档可以快速定位到目标提交再用get查看其完整状态。输出格式默认文本、JSON 与 TSVget命令的输出模式受全局 Flag 控制默认情况下输出为稳定的「字段名\t字段值」文本行。依据源码输出逻辑默认输出包含以下字段输出字段说明输出条件id提交 ID总是输出user_id提交学生用户 ID总是输出state提交状态总是输出late是否迟交true/false总是输出draft_grade草稿成绩总是输出空值显示为空assigned_grade已评定成绩总是输出空值显示为空updated更新时间RFC3339仅当 API 返回 UpdateTime 非空时link网页端替代链接AlternateLink仅当 API 返回 AlternateLink 非空时成绩字段经过formatFloatValue格式化见 classroom_helpers.go会去掉多余的尾随零例如5.50显示为5.5便于阅读与二次解析。JSON 模式脚本化首选添加-j/--json/--machine后命令输出标准的 JSON 结构外层包裹一个submission键gog classroom submissions get -j courseId courseworkId submissionId{ submission: { id: 123456789, userId: studentexample.com, state: TURNED_IN, late: false, draftGrade: 9.5, assignedGrade: 10, updateTime: 2026-09-10T08:30:00Z, alternateLink: https://classroom.google.com/c/... } }JSON 模式与--results-only只输出主结果丢弃 envelope 字段、--select按逗号分隔字段选择输出支持点路径可组合使用便于在 jq 等工具中进一步加工。其他输出相关 Flag-p/--plain/--tsv输出稳定、可解析的 TSV 文本无颜色渲染适合 CI 与管道处理。--color默认auto控制颜色输出可选auto|always|never。--wrap-untrusted在 JSON/raw 输出中为外部获取的文本字段加上不受信内容标记。全局 Flag 一览get命令继承 gogcli 全部根级 Flag下表为完整清单取自命令参考文档FlagTypeDefaultHelp--access-tokenstringUse provided access token directly (bypasses stored refresh tokens; token expires in ~1h)-a--account--acctstringAccount email, alias, or auto for authenticated Google API commands--clientstringOAuth client name (selects stored credentials token bucket)--colorstringautoColor output: auto|always|never--disable-commandsstringComma-separated list of disabled commands; dot paths allowed-n--dry-run--dryrun--noop--previewboolDo not make changes; print intended actions and exit successfully--enable-commandsstringComma-separated list of enabled command prefixes; dot paths allowed (restricts CLI)--enable-commands-exactstringComma-separated list of exact enabled commands; dot paths allowed and parent commands do not enable children-y--force--assume-yes--yesboolSkip confirmations for destructive commands--gmail-no-sendboolfalseBlock Gmail send operations (agent safety)-h--helpkong.helpFlagShow context-sensitive help.--homestringOverride gogcli config/data/state/cache root (equivalent to GOG_HOME)-j--json--machineboolfalseOutput JSON to stdout (best for scripting)--no-input--non-interactive--noninteractiveboolNever prompt; fail instead (useful for CI)-p--plain--tsvboolfalseOutput stable, parseable text to stdout (TSV; no colors)--quota-projectstringGoogle Cloud project to bill for API usage (sent as X-Goog-User-Project; some APIs require it with --access-token or ADC)--readonlyboolfalseBlock mutating API requests at runtime; auth add also requests read-only OAuth scopes--results-onlyboolIn JSON mode, emit only the primary result (drops envelope fields like nextPageToken)--select--pick--projectstringIn JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands.-v--verboseboolEnable verbose logging--versionkong.VersionFlagPrint version and exit--wrap-untrustedboolfalseIn JSON/raw output, wrap fetched text fields in external untrusted-content markers几个与本命令强相关的 Flag 使用建议--account/--acct指定账户邮箱或别名未指定时使用默认账户。get是认证命令通过requireAccount(flags)解析账户。--access-token直接使用提供的访问令牌绕过存储的刷新令牌注意令牌约 1 小时过期适合临时凭据场景。--quota-project指定用于 API 配额计费的 Google Cloud 项目以X-Goog-User-Project头发送某些 API 在使用--access-token或 ADC 时必须配置。--readonly在运行时拦截所有变更类 API 请求且auth add时只申请只读 OAuth scopeget为只读操作与该 Flag 天然兼容。--no-input/--non-interactiveCI 环境下禁止交互提示遇到需要确认的场景直接失败。源码级原理一条命令的完整调用链理解底层实现有助于判断命令行为与排障。get的完整调用链如下账户解析Run方法首先调用requireAccount(flags)确定使用哪个 Google 账户对应internal/cmd/classroom_submissions.go中ClassroomSubmissionsGetCmd.Run。服务构建通过classroomService(ctx, account)创建 Classroom API 服务客户端。其底层实现在 internal/googleapi/classroom.go即NewClassroom使用googleauth.ServiceClassroom服务名注册表创建classroom.NewService按账户隔离凭据与令牌桶。参数校验三个位置参数去空白后逐一非空校验空值直接返回 usage 错误。API 调用执行svc.Courses.CourseWork.StudentSubmissions.Get(courseID, courseworkID, submissionID).Context(ctx).Do()即 Google Classroom API 的courses.courseWork.studentSubmissions.get接口。错误包装失败时经wrapClassroomError统一包装见 classroom_helpers.go对两类典型错误给出可执行提示。输出按 JSON 或默认文本模式渲染结果。值得注意的是整个调用链与turn-in、reclaim、return、grade共享同一套账户解析与服务构建逻辑见 classroom_submissions.go 中submissionAction与ClassroomSubmissionsGradeCmd而grade还会通过buildClassroomSubmissionGradePlan生成 updateMask 后调用Patch相关单测见 classroom_submissions_plan_test.go说明 gogcli 对提交域的操作采用统一的规划-执行模式get是其只读端点。错误处理与排障指南依据 wrapClassroomError 的实现get命令会针对两类高频错误输出可执行的修复提示Classroom API 未启用当错误信息包含accessNotConfigured或Classroom API has not been used时提示需要在 Google Cloud Console 中启用 Classroom APIclassroom.googleapis.com。权限不足当错误信息包含insufficientPermissions或insufficient authentication scopes时提示使用gog auth add account --services classroom重新认证以获取 Classroom 相关 OAuth scope。其他常见问题参数错误任何 ID 为空都会立即返回 usage 错误empty courseId等不会发起网络请求可通过-h查看帮助确认参数顺序。找不到提交若courseId、courseworkId、submissionId组合不匹配例如提交不属于该作业API 会返回 NOT_FOUND 类错误此时建议用list复核 ID。CI 场景搭配-j --no-input可避免任何交互阻塞若需要在无结果场景下区分成功/失败可参考list的--fail-empty语义设计自己的退出码判断。实战示例# 默认文本输出 gog classroom submissions get 123456789 cw-001 sub-001 # 输出示例文本模式 # id sub-001 # user_id studentexample.com # state TURNED_IN # late false # draft_grade 9.5 # assigned_grade 10 # updated 2026-09-10T08:30:00Z # link https://classroom.google.com/c/... # JSON 输出供 jq 消费 gog classroom submissions get -j 123456789 cw-001 sub-001 | jq .submission.state # 指定账户 明文 TSV gog classroom submissions get -p --account teacherschool.edu 123456789 cw-001 sub-001从仓库中的实时测试脚本可看到该命令族的端到端验证方式scripts/live-tests/classroom.sh中会先创建课程与作业再执行gog classroom submissions list $course_id $cw_id --max 1 --json获取提交列表为get类命令准备测试数据这同样是一套可参考的「先 list 再 get」实战流程。小结gog classroom submissions get是 gogcli Classroom 提交域中轻量、只读、适合脚本化的查询端点。它用三个 ID 精确定位提交默认输出稳定文本、可选 JSON/TSV 模式并内置了针对「API 未启用」「权限不足」两类高频错误的可执行提示。结合其兄弟命令list/grade/return等见 命令索引可以在终端中完成从查看提交、评定成绩到返回提交的完整教学管理闭环。延伸阅读gog classroom submissions 命令族总览gog classroom submissions list获取提交 IDgog classroom submissions grade设置成绩gog classroom 命令族提交域命令源码Classroom API 服务构建与错误包装 与 classroom_helpers.go实时测试脚本 classroom.sh【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
