Method: courses.students.create

เพิ่มผู้ใช้เป็นนักเรียนของหลักสูตร

ผู้ดูแลระบบโดเมนได้รับอนุญาตให้เพิ่มผู้ใช้ภายในโดเมนของตนเป็นนักเรียนในหลักสูตรภายในโดเมนได้โดยตรง นักเรียนสามารถเพิ่มตนเองลงในคอร์สได้โดยใช้รหัสลงทะเบียน

วิธีการนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

  • PERMISSION_DENIED หากผู้ใช้ที่ส่งคำขอไม่ได้รับอนุญาตให้สร้างนักเรียนในหลักสูตรนี้ หรือมีข้อผิดพลาดในการเข้าถึง
  • NOT_FOUND หากรหัสหลักสูตรที่ขอไม่มีอยู่
  • FAILED_PRECONDITION หากบัญชีของผู้ใช้ที่ขอถูกปิดใช้ ข้อผิดพลาดเกี่ยวกับคำขอต่อไปนี้จะปรากฏขึ้น
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS หากผู้ใช้เป็นนักเรียนหรือครูในหลักสูตรอยู่แล้ว

คำขอ HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/students

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
courseId

string

ตัวระบุของหลักสูตรที่จะสร้างนักเรียน ตัวระบุนี้อาจเป็นตัวระบุที่ Classroom กำหนดหรือ alias ก็ได้

พารามิเตอร์การค้นหา

พารามิเตอร์
enrollmentCode

string

รหัสการลงทะเบียนของหลักสูตรที่จะสร้างนักเรียน จำเป็นต้องใช้รหัสนี้หาก userId สอดคล้องกับผู้ใช้ที่ส่งคำขอ แต่สามารถละเว้นได้หากผู้ใช้ที่ส่งคำขอมีสิทธิ์ระดับผู้ดูแลระบบในการสร้างนักเรียนให้กับผู้ใช้รายใดก็ได้

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ Student

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Student ที่สร้างขึ้นใหม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์