REST Resource: courses.announcements

แหล่งข้อมูล: ประกาศ

ประกาศที่ครูสร้างขึ้นสำหรับนักเรียนในหลักสูตร

การแสดง JSON 
{
  "courseId": string,
  "id": string,
  "text": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (AnnouncementState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string
}
ช่อง
courseId

string

ตัวระบุของหลักสูตร

อ่านอย่างเดียว
id

string

ตัวระบุที่ Classroom กำหนดให้ประกาศนี้ ซึ่งไม่ซ้ำกันต่อหลักสูตร

อ่านอย่างเดียว
text

string

คำอธิบายประกาศนี้ ข้อความต้องเป็นสตริง UTF-8 ที่ถูกต้องซึ่งมีอักขระไม่เกิน 30,000 ตัว
materials[]

object (Material)

สื่อเพิ่มเติม

ประกาศต้องมีรายการเนื้อหาไม่เกิน 20 รายการ
state

enum (AnnouncementState)

สถานะของประกาศนี้ หากไม่ระบุ สถานะเริ่มต้นจะเป็น DRAFT
creationTime

string (Timestamp format)

การประทับเวลาเมื่อสร้างประกาศนี้

อ่านอย่างเดียว

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็น Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่าง: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

การประทับเวลาของการเปลี่ยนแปลงล่าสุดในประกาศนี้

อ่านอย่างเดียว

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็น Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่าง: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
scheduledTime

string (Timestamp format)

การประทับเวลาที่ไม่บังคับเมื่อกำหนดเวลาให้เผยแพร่ประกาศนี้

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็น Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่าง: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
assigneeMode

enum (AssigneeMode)

โหมดผู้รับมอบหมายของประกาศ หากไม่ได้ระบุ ค่าเริ่มต้นจะเป็น ALL_STUDENTS
individualStudentsOptions

object (IndividualStudentsOptions)

ตัวระบุของนักเรียน/นักศึกษาที่มีสิทธิ์เข้าถึงประกาศ ระบบจะตั้งค่าช่องนี้ก็ต่อเมื่อ assigneeMode เป็น INDIVIDUAL_STUDENTS เท่านั้น หากassigneeModeเป็น INDIVIDUAL_STUDENTS แสดงว่าเฉพาะนักเรียนที่ระบุในช่องนี้เท่านั้นที่จะเห็นประกาศ
creatorUserId

string

ตัวระบุสำหรับผู้ใช้ที่สร้างประกาศ

อ่านอย่างเดียว

AnnouncementState

สถานะที่เป็นไปได้ของประกาศ

Enum
ANNOUNCEMENT_STATE_UNSPECIFIED ไม่ได้ระบุรัฐ และจะไม่มีการคืนเงิน
PUBLISHED สถานะของประกาศที่เผยแพร่แล้ว ซึ่งเป็นสถานะเริ่มต้น
DRAFT สถานะของประกาศที่ยังไม่ได้เผยแพร่ ประกาศในสถานะนี้จะแสดงต่อครูผู้สอนหลักสูตรและผู้ดูแลระบบโดเมนเท่านั้น
DELETED สถานะของประกาศที่เผยแพร่แล้วแต่ถูกลบไปแล้ว ประกาศในสถานะนี้จะแสดงต่อครูผู้สอนหลักสูตรและผู้ดูแลระบบโดเมนเท่านั้น ระบบจะลบประกาศในสถานะนี้หลังจากผ่านไประยะหนึ่ง

เมธอด

create

 สร้างประกาศ

delete

 ลบประกาศ

get

 แสดงประกาศ

getAddOnContext

 รับข้อมูลเมตาสำหรับส่วนเสริมของ Classroom ในบริบทของโพสต์ที่เฉพาะเจาะจง

list

 แสดงผลรายการประกาศที่ผู้ขอมีสิทธิ์ดู

modifyAssignees

 แก้ไขโหมดผู้รับมอบหมายและตัวเลือกของประกาศ

patch

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