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

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