REST Resource: courses.courseWork

{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "gradingPeriodId": string
}

string

تمثّل هذه السمة معرّف الدورة التدريبية.

للقراءة فقط.

string

تمثّل هذه السمة المعرّف الذي حدّده Classroom للعمل في الدورة التدريبية، ويكون فريدًا لكل دورة تدريبية.

للقراءة فقط.

string

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

string

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

object (Material)

مواد إضافية

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

enum (CourseWorkState)

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

string

رابط مطلق لهذا العمل في الدورة التدريبية في واجهة مستخدم الويب في Classroom. لا تتم تعبئة هذه السمة إلا إذا كانت قيمة state هي PUBLISHED.

للقراءة فقط.

string (Timestamp format)

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

للقراءة فقط.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

الطابع الزمني لأحدث تغيير في هذه الدورة التدريبية.

للقراءة فقط.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

object (Date)

التاريخ الاختياري (بالتوقيت العالمي المنسق) لموعد إرسال المهام الدراسية لهذه الدورة التدريبية. يجب تحديد ذلك إذا تم تحديد dueTime.

object (TimeOfDay)

الوقت الاختياري من اليوم، بالتوقيت العالمي المنسّق (UTC)، موعد تسليم المهام الدراسية لهذه الدورة التدريبية. يجب تحديد ذلك إذا تم تحديد dueDate.

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

number

الدرجة القصوى لعمل الدورة التدريبية. إذا كانت المهمة صفر أو غير محدّدة، ستُعتبر هذه المهمة بلا درجات. يجب أن تكون هذه القيمة عددًا صحيحًا غير سالب.

enum (CourseWorkType)

نوع عمل الدورة التدريبية هذه.

يتم ضبط النوع عند إنشاء مهمة الدورة التدريبية ولا يمكن تغييره.

boolean

ما إذا كان عنصر عمل الدورة التدريبية هذا مرتبطًا بمشروع Play Console الذي قدّم الطلب.

لمزيد من التفاصيل، يُرجى الانتقال إلى courseWork.create.

للقراءة فقط.

enum (AssigneeMode)

وضع المُسنَد إليه في الدورة الدراسية. في حال عدم تحديد القيمة، تكون القيمة التلقائية هي ALL_STUDENTS.

object (IndividualStudentsOptions)

معرّفات الطلاب الذين يمكنهم الوصول إلى مهام الدورة الدراسية يتم ضبط هذا الحقل فقط إذا كانت قيمة assigneeMode هي INDIVIDUAL_STUDENTS. إذا كانت قيمة السمة assigneeMode هي INDIVIDUAL_STUDENTS، سيتم إسناد مهام الدورة الدراسية إلى الطلاب المحدَّدين في هذا الحقل فقط.

enum (SubmissionModificationMode)

إعداد لتحديد الوقت الذي يُسمح فيه للطلاب بتعديل المهام الدراسية في حال عدم تحديد القيمة، تكون القيمة التلقائية هي MODIFIABLE_UNTIL_TURNED_IN.

string

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

للقراءة فقط.

string

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

object (GradeCategory)

تمثل هذه السمة الفئة التي يساهم فيها درجة الواجب الدراسي هذا. لا يتم العرض إلا عند اختيار فئة لواجب الدورة الدراسية. ويمكن استخدامه في حساب الدرجة الإجمالية.

للقراءة فقط.

enum (PreviewVersion)

النتائج فقط. إصدار المعاينة من واجهة برمجة التطبيقات المُستخدَم لاسترداد هذا المورد

object (Assignment)

تفاصيل المهمة لا تتم تعبئة هذا الحقل إلا عندما تكون قيمة workType هي ASSIGNMENT.

للقراءة فقط.

object (MultipleChoiceQuestion)

تفاصيل أسئلة الاختيار من متعدد بالنسبة إلى عمليات القراءة، لا تتم تعبئة هذا الحقل إلا عندما تكون قيمة workType هي MULTIPLE_CHOICE_QUESTION. بالنسبة إلى عمليات الكتابة، يجب تحديد هذا الحقل عند إنشاء عمل الدورة التدريبية باستخدام workType من MULTIPLE_CHOICE_QUESTION، ويجب عدم ضبطه على نحو آخر.

string

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

• في حال عدم تحديد رقم التعريف، سيتم ضبط رقم التعريف الخاص بفترة وضع الدرجات استنادًا إلى dueDate (أو scheduledTime في حال عدم ضبط dueDate).
• للإشارة إلى عدم ارتباط بأي فترة وضع درجات، اضبط هذا الحقل على سلسلة فارغة ("").
• إذا تم تحديده، يجب أن يتطابق مع رقم تعريف حالي لفترة وضع الدرجات في الدورة التدريبية.

{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}

object (DriveFolder)

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

{
  "choices": [
    string
  ]
}

string

الخيارات المحتملة.