Method: courses.updateGradingPeriodSettings

อัปเดตการตั้งค่าระยะเวลาการให้คะแนนของหลักสูตร

คุณเพิ่ม นําออก หรือแก้ไขระยะเวลาการให้คะแนนแต่ละรายการได้โดยใช้วิธีนี้

ผู้ใช้ที่ส่งคำขอและเจ้าของหลักสูตรต้องมีสิทธิ์แก้ไขระยะเวลาการให้คะแนน โปรดดูรายละเอียดที่หัวข้อข้อกำหนดในการอนุญาตให้ใช้สิทธิ

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

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

คำขอ HTTP

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

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

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

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

string

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

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

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

string (FieldMask format)

มาสก์ที่ระบุฟิลด์ใน GradingPeriodSettings ที่จะอัปเดต

ระบบจะแทนที่รายการ GradingPeriodSettings gradingPeriods ด้วยระยะเวลาการให้คะแนนที่ระบุในคำขออัปเดตโดยสมบูรณ์ เช่น

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

คุณสามารถระบุฟิลด์ต่อไปนี้

  • gradingPeriods
  • applyToExistingCoursework

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

enum (PreviewVersion)

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

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

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

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

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

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

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

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

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