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)

חותמת הזמן של מועד יצירת ההודעה.

קריאה בלבד.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

חותמת הזמן של השינוי האחרון בהודעה הזו.

קריאה בלבד.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
scheduledTime

string (Timestamp format)

חותמת זמן אופציונלית של מועד הפרסום המתוזמן של ההודעה.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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 סטטוס של הודעה לכיתה שפורסמה אבל נמחקה עכשיו. הודעה במצב כזה גלויה רק למורים בקורס ולאדמינים בדומיין. הודעה במצב כזה נמחקת אחרי זמן מה.

Methods

create

 יצירת הודעה.

delete

 מחיקת הודעה.

get

 הפונקציה מחזירה הודעה.

getAddOnContext

 הצגת המטא-נתונים של תוספים ל-Classroom בהקשר של פוסט ספציפי.

list

 הפונקציה מחזירה רשימה של ההודעות שהמבקש מורשה לראות.

modifyAssignees

 שינוי המצב והאפשרויות של הקצאת ההודעה.

patch

 עדכון של שדה אחד או יותר בהודעה.