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

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