Method: courses.courseWork.patch

อัปเดตงานในหลักสูตรอย่างน้อย 1 ช่อง

ดูรายละเอียดของช่องที่อาจได้รับการอัปเดตและผู้ที่เปลี่ยนแปลงได้ที่ google.classroom.v1.CourseWork

คำขอนี้ต้องดำเนินการโดยโปรเจ็กต์ Developer Console ของรหัสไคลเอ็นต์ OAuth ที่ใช้สร้างรายการงานของหลักสูตรที่เกี่ยวข้อง

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

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

คำขอ HTTP

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

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

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

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

string

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

string

ตัวระบุของงานในหลักสูตร

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

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

string (FieldMask format)

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

ครูอาจระบุข้อมูลในช่องต่อไปนี้

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId พร้อมใช้งานใน V1_20240401_PREVIEW และใหม่กว่า

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

enum (PreviewVersion)

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

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

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

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

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

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

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

  • https://www.googleapis.com/auth/classroom.coursework.students

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