Method: courses.courseWorkMaterials.patch

อัปเดตฟิลด์อย่างน้อย 1 ฟิลด์ของสื่อการเรียนการสอน

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

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

คำขอ HTTP

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

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

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

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

string

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

string

ตัวระบุของสื่องานในชั้นเรียน

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

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

string (FieldMask format)

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

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

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

enum (PreviewVersion)

ไม่บังคับ เวอร์ชันตัวอย่างของอุปกรณ์ปลายทาง

PREVIEW_VERSION_9001 มีความสามารถใหม่ดังนี้ * รองรับการอัปเดตวัสดุ หากต้องการอัปเดตสื่อ ให้ใช้ updateMask "materials" รายการเนื้อหาที่ระบุในออบเจ็กต์ CourseWorkMaterial ของคำขอจะแทนที่รายการที่มีอยู่ทั้งหมด ล้างฟิลด์วัสดุได้โดยระบุ "materials" ในมาสก์การอัปเดตและไม่ได้อยู่ในออบเจ็กต์ CourseWorkMaterial ขณะนี้ยังไม่รองรับการอัปเดตCourseWorkMaterialที่เผยแพร่แล้ว

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

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

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

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

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

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

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

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