Method: courses.topics.patch

อัปเดตช่องอย่างน้อย 1 ช่องของหัวข้อ

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

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

คำขอ HTTP

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

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

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

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

string

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

string

ตัวระบุของหัวข้อ

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

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

string (FieldMask format)

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

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

  • name

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

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

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

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

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

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

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

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

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