Method: courses.courseWork.rubrics.patch

อัปเดตเกณฑ์การให้คะแนน

ดูรายละเอียดเกี่ยวกับฟิลด์ที่อัปเดตได้ที่ google.classroom.v1.Rubric ความสามารถในการอัปเดตเกณฑ์การให้คะแนนจะจำกัดเมื่อเริ่มให้คะแนนแล้ว

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

คำขอนี้ต้องส่งจากคอนโซล Google Cloud ของรหัสไคลเอ็นต์ OAuth ที่ใช้สร้างรายการงานของหลักสูตรหลัก

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

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

คำขอ HTTP

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

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

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

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

string

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

string

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

string

ไม่บังคับ ตัวระบุของรูปแบบการให้คะแนน

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

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

string (FieldMask format)

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

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

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

  • criteria
  • sourceSpreadsheetId

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

enum (PreviewVersion)

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

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

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

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

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

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

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

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

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