使用Google Apps Script邀请学生加入Classroom遇错求助

1. 修正API调用路径错误 #

你之前写的Classroom.Courses.invitations.create路径有误，Google Classroom API中创建邀请的正确调用路径是Classroom.Invitations.create——Classroom.Courses对象下并没有invitations子模块，这是触发TypeError: Cannot read properties of undefined (reading 'create')的核心原因。

2. 修正参数格式问题 #

代码里还有两个关键错误：

• userId未加引号：邮箱地址属于字符串类型，必须用双引号或单引号包裹，否则JS会把student1.xxxxx.ac.uk当作未定义变量解析，引发错误。
• role枚举值使用错误：文档里的"enum"类型指role字段只能接受固定的有效值，在JS中需要以字符串形式传入，即"STUDENT"，直接写STUDENT会被视为未定义变量，导致参数无效。

3. 正确代码示例 #

Classroom.Invitations.create({
  "userId": "student1.xxxxx.ac.uk",
  "courseId": 653541812880,
  "role": "STUDENT"
});

4. 针对"Requested entity was not found"错误的额外排查 #

如果修正后仍出现该错误，可检查以下几点：

• 确认课程ID对应的课程真实存在，且你拥有该课程的管理权限（所有者或教师角色）
• 确认用户邮箱是有效的Google账号（Classroom邀请仅支持Google账号用户）
• 若用户已加入目标课程，重复发送邀请也会触发该错误，可先调用Classroom.Courses.Students.list检查用户是否已在课程中

内容的提问来源于stack exchange，提问作者Tony Johnson