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 "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

 تُحدّث حقلاً واحدًا أو أكثر من مواد عمل الدورة التدريبية.