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" بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

الطابع الزمني لآخر تغيير تم إجراؤه على هذا الإشعار

للقراءة فقط:

طابع زمني بتنسيق RFC3339 UTC "Zulu" بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
scheduledTime

string (Timestamp format)

طابع زمني اختياري للوقت الذي تمت فيه جدولة هذا الإشعار لنشره.

طابع زمني بتنسيق RFC3339 UTC "Zulu" بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "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

معرّف المستخدم الذي أنشأ الإشعار.

للقراءة فقط:

حالة الإعلان

الحالات المحتملة للإشعارات

عمليات التعداد
ANNOUNCEMENT_STATE_UNSPECIFIED لم يتم تحديد ولاية. ولا يتم إرجاع هذه القيمة مطلقًا.
PUBLISHED حالة الإشعار الذي تم نشره هذه هي الحالة التلقائية.
DRAFT الحالة لإعلان لم يتم نشره بعد. لا يظهر الإشعار بهذه الحالة إلا لمعلّمي الدورة التدريبية ومشرفي النطاق.
DELETED حالة الإشعار الذي تم نشره ولكن تم حذفه الآن لا يظهر الإشعار بهذه الحالة إلا لمعلّمي الدورة التدريبية ومشرفي النطاق. يتم حذف الإشعار الذي يستمر هذا الوضع بعد فترة من الوقت.

الطُرق

create

 ينشئ إعلانًا.

delete

 حذف إشعار

get

 تعرض إشعارًا.

getAddOnContext

 الحصول على البيانات الوصفية لإضافات Classroom في سياق مشاركة معيّنة

list

 تعرض قائمة بالإعلانات التي يُسمح لمقدِّم الطلب بالاطّلاع عليها.

modifyAssignees

 لتعديل وضع المُسنَد إليه وخيارات الإشعار.

patch

 عدِّل حقلاً واحدًا أو أكثر من الإشعار.