Method: courses.announcements.patch

อัปเดตช่องของประกาศอย่างน้อย 1 ช่อง

โดยวิธีส่งคืนรหัสข้อผิดพลาดต่อไปนี้

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

คำขอ HTTP

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

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

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

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

string

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

id

string

ตัวระบุประกาศ

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

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

string (FieldMask format)

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

ครูอาจระบุช่องต่อไปนี้

  • text
  • state
  • scheduledTime

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

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

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

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

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อภาพรวม OAuth 2.0