Method: courses.patch

อัปเดตฟิลด์อย่างน้อย 1 รายการในหลักสูตร

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

  • PERMISSION_DENIED หากผู้ใช้ที่ขอไม่มีสิทธิ์แก้ไขหลักสูตรที่ขอหรือสำหรับข้อผิดพลาดในการเข้าถึง
  • NOT_FOUND หากไม่มีหลักสูตรที่มีรหัสที่ขอ
  • INVALID_ARGUMENT หากระบุฟิลด์ที่ไม่ถูกต้องในมาสก์การอัปเดต หรือหากไม่ได้ระบุมาสก์การอัปเดต
  • FAILED_PRECONDITION สำหรับข้อผิดพลาดในคำขอต่อไปนี้
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner
    • CourseTitleCannotContainUrl

คำขอ HTTP

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

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

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

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

string

ตัวระบุของหลักสูตรที่จะอัปเดต ตัวระบุนี้อาจเป็นตัวระบุที่ Classroom กำหนดให้หรือเป็น alias ก็ได้

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

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

string (FieldMask format)

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

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

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

เมื่อตั้งค่าในพารามิเตอร์การค้นหา ควรระบุฟิลด์นี้เป็น

updateMask=<field1>,<field2>,...

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

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

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

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

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

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

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

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

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