Method: courses.studentGroups.patch

• คำขอ HTTP
• พารามิเตอร์เส้นทาง
• พารามิเตอร์การค้นหา
• เนื้อความของคำขอ
• เนื้อหาการตอบกลับ
• ขอบเขตการให้สิทธิ์

เวอร์ชันตัวอย่างสำหรับนักพัฒนาแอป: พร้อมใช้งานเป็นส่วนหนึ่งของโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอปของ Google Workspace ซึ่งให้สิทธิ์ทดลองใช้ฟีเจอร์บางอย่างก่อนเปิดตัว ฟีเจอร์นี้พร้อมใช้งานใน V1_20250630_PREVIEW ขึ้นไป ดูข้อมูลเพิ่มเติมได้ที่เข้าถึง API เวอร์ชันตัวอย่าง

อัปเดตฟิลด์อย่างน้อย 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

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