Method: courses.studentGroups.patch

อัปเดตฟิลด์อย่างน้อย 1 รายการในกลุ่มนักเรียน

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

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

คำขอ HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{id}

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

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

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

string

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

string

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

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

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

string (FieldMask format)

ต้องระบุ มาสก์ที่ระบุช่องในกลุ่มนักเรียนที่จะอัปเดต ต้องระบุข้อมูลในช่องนี้เพื่อทำการอัปเดต การอัปเดตจะล้มเหลวหากมีการระบุฟิลด์ที่ไม่ถูกต้อง

ครูสามารถระบุช่องต่อไปนี้ได้

  • title

ซึ่งเป็นรายการชื่อฟิลด์แบบสมบูรณ์ในตัวเองที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
previewVersion

enum (PreviewVersion)

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

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

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ StudentGroup

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

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

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

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