Method: courses.studentGroups.studentGroupMembers.create

สร้างสมาชิกกลุ่มนักเรียนสำหรับกลุ่มนักเรียน

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

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

คำขอ HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers

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

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

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

string

ต้องระบุ ตัวระบุของหลักสูตร
studentGroupId

string

ต้องระบุ ตัวระบุของกลุ่มนักเรียน

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

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

enum (PreviewVersion)

ไม่บังคับ API เวอร์ชันตัวอย่าง คุณต้องตั้งค่านี้เพื่อเข้าถึงความสามารถใหม่ของ API ที่พร้อมให้บริการแก่นักพัฒนาแอปในโปรแกรมเวอร์ชันตัวอย่าง

เนื้อความของคำขอ

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

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

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

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

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

  • https://www.googleapis.com/auth/classroom.rosters

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