REST Resource: courses.courseWorkMaterials

المرجع: CourseWorkMaterial

مواد عمل الدورة التدريبية التي أنشأها معلّم لطلاب الدورة التدريبية

تمثيل JSON 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": string
}
الحقول
courseId

string

تمثّل هذه السمة معرّف الدورة التدريبية.

للقراءة فقط.
id

string

المعرّف الذي عيّنه Classroom لمادة العمل الخاصة بالدورة التدريبية هذه، وهو فريد لكل دورة تدريبية

للقراءة فقط.
title

string

عنوان مادة عمل الدورة التدريبية هذه. يجب أن يكون العنوان سلسلة UTF-8 صالحة تحتوي على ما بين حرف واحد و3,000 حرف.
description

string

وصف اختياري لمواد عمل الدورة التدريبية هذه. يجب أن يكون النص سلسلة UTF-8 صالحة لا يحتوي على أكثر من 30,000 حرف.
materials[]

object (Material)

مواد إضافية

يجب ألا تحتوي مواد عمل الدورة التدريبية على أكثر من 20 عنصرًا.
state

enum (CourseWorkMaterialState)

حالة مادة عمل الدورة التدريبية هذه وفي حال عدم تحديد الحالة، ستكون الولاية التلقائية هي 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

معرّف للمستخدم الذي أنشأ مادة عمل الدورة التدريبية

للقراءة فقط.
topicId

string

تمثّل هذه السمة معرّف الموضوع الذي ترتبط به مواد عمل الدورة التدريبية. يجب أن يتطابق مع موضوع حالي في الدورة التدريبية.

CourseWorkMaterialState

الحالات المحتملة لمادة عمل الدورة

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

الطُرق

create

 تنشئ مادة عمل الدورة التدريبية.

delete

 يؤدي هذا الإجراء إلى حذف مادة من مهام الدورة التدريبية.

get

 تعرض مادة عمل الدورة التدريبية.

getAddOnContext

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

list

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

patch

 تُستخدَم لتعديل حقل واحد أو أكثر من مواد العمل الدراسي.