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

string (Timestamp format)

الطابع الزمني لأحدث تغيير على هذا الإشعار

للقراءة فقط.

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

string (Timestamp format)

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

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

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

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

الطُرق

create

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

delete

 حذف إعلان

get

 عرض إعلان.

getAddOnContext

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

list

 عرض قائمة بالإشعارات المسموح لمقدّم الطلب بالاطّلاع عليها

modifyAssignees

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

patch

 تعمل على تعديل حقل واحد أو أكثر من الإشعارات.