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

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