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)

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

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

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

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
scheduledTime

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
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 ช่อง