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 ช่อง