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,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
الحقول
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 في النهاية ويستخدم الأرقام الجزئية 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 في النهاية ويستخدم الأرقام الجزئية 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 في النهاية ويستخدم الأرقام الجزئية 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

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

object (LearningGoal)

اختياريّ.

إشارات إلى أي أهداف تعليمية مرفقة بمادة العمل الدراسي هذه يمكن أن يتضمّن CourseWorkMaterial 10 أهداف تعلّم كحدّ أقصى. ولا تتم تعبئة هذا الحقل إلا إذا تم ضبط previewVersion المناسب.

CourseWorkMaterialState

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

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

الطُرق

create

 تنشئ هذه الطريقة مادة عمل للدورة التدريبية.

delete

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

get

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

getAddOnContext

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

list

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

patch

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