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

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

للقراءة فقط.

AnnouncementState

الحالات المحتملة للإعلانات

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

الطُرق

create

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

delete

 يؤدي هذا الإجراء إلى حذف إعلان.

get

 لعرض إشعار.

getAddOnContext

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

list

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

modifyAssignees

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

patch

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