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

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

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

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

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

string

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

CourseWorkMaterialState

الحالات المحتمَلة لمادة عمل الدورة الدراسية

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

الطُرق

create

 إنشاء مادة عمل الدورة التدريبية

delete

 لحذف مادة عمل الدورة التدريبية

get

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

getAddOnContext

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

list

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

patch

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