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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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 ช่องของประกาศ