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 โดยจะใช้เพียงตัวเลือกเดียวในการกำหนดเกณฑ์การให้คะแนนได้ทีละ 1 รายการ

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

ครูสามารถระบุช่องต่อไปนี้ได้

  • criteria
  • sourceSpreadsheetId

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

enum (PreviewVersion)

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

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

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

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

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

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

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

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

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