Method: courses.patch

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

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

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

คำขอ 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

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