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
  • learningGoals

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

enum (PreviewVersion)

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

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

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

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

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

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

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

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

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