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

المعرّف الذي تحدّده "الفصول الدراسية" لهذا الإشعار، وهو فريد لكل دورة دراسية.

للقراءة فقط.
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

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