调用Google Classroom API更新学生作业成绩时出现updateMask 400错误如何解决

Google Classroom API 成绩更新400错误修复方案 #

• HTTP 请求方法错误：更新学生作业成绩必须使用PATCH方法，使用PUT/POST都会触发该400错误，哪怕请求参数符合要求也会报错。
• updateMask 参数格式错误：
  1. 字段名必须严格匹配API要求的draftGrade或assignedGrade小驼峰格式，不能写成蛇形draft_grade、大驼峰DraftGrade或者其他变体
  2. 如果你同时更新两个字段，多个字段之间必须用英文逗号分隔，不能用空格、分号等其他符号，正确写法示例：updateMask=draftGrade,assignedGrade
• 请求体结构层级错误：draftGrade/assignedGrade字段必须放在请求体的根层级，不能嵌套在其他对象下。示例：错误写法{"studentSubmission": {"draftGrade": 90}}，正确写法{"draftGrade": 90}
• 权限范围不足：请求的OAuth授权必须包含https://www.googleapis.com/auth/classroom.coursework.students权限，仅授予只读权限或者其他不匹配的权限也可能触发参数校验异常
• 参数值类型错误：draftGrade/assignedGrade必须是数值类型，不能用字符串包裹。示例：正确写法"draftGrade": 85，错误写法"draftGrade": "85"

正确请求示例（curl） #

curl --request PATCH \
  'https://classroom.googleapis.com/v1/courses/{课程ID}/courseWork/{作业ID}/studentSubmissions/{学生提交ID}?updateMask=draftGrade' \
  --header 'Authorization: Bearer {你的OAuth令牌}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "draftGrade": 90
  }'

内容的提问来源于stack exchange，提问作者Francislainy Campos