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 صالحة تتضمّن ما بين حرف واحد و3000 حرف.
description

string

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

object (Material)

مواد إضافية

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

enum (CourseWorkMaterialState)

حالة مادة العمل في هذه الدورة التدريبية. إذا لم يتم تحديدها، تكون الحالة التلقائية هي DRAFT.
creationTime

string (Timestamp format)

الطابع الزمني لوقت إنشاء مادة العمل هذه للدورة التدريبية

للقراءة فقط.

يستخدم هذا النوع RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

الطابع الزمني لآخر تغيير تم إجراؤه على مادة العمل في هذه الدورة التدريبية

للقراءة فقط.

يستخدم هذا النوع RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

طابع زمني اختياري لتحديد موعد نشر مادة العمل في هذه الدورة التدريبية

يستخدم هذا النوع RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
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

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