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)
  },

  // 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.
}

string

معرّف الدورة التدريبية.

للقراءة فقط.

string

معرّف مخصّص للصف الدراسي لعمل الدورة التدريبية هذا، وهو فريد لكل دورة تدريبية.

للقراءة فقط.

string

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

string

وصف اختياري لعمل الدورة التدريبية هذا. إذا تم التعيين، يجب أن يكون الوصف سلسلة UTF-8 صالحة لا يزيد طولها عن 30000 حرف.

object (Material)

مواد إضافية.

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

enum (CourseWorkState)

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

string

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

للقراءة فقط.

string (Timestamp format)

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

للقراءة فقط.

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

string (Timestamp format)

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

للقراءة فقط.

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

object (Date)

التاريخ الاختياري بالتوقيت العالمي المتّفق عليه الذي يُعدّ فيه موعد تسليم مهام هذه الدورة التدريبية. يجب تحديد هذا إذا تم تحديد dueTime.

object (TimeOfDay)

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu"، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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)

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

للقراءة فقط.

object (Assignment)

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

للقراءة فقط.

object (MultipleChoiceQuestion)

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

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

سنة التاريخ يجب أن تتراوح القيمة بين 1 و9999 أو 0 لتحديد تاريخ بدون عام.

integer

شهر من السنة. يجب أن تتراوح القيمة بين 1 و12 أو 0 لتحديد سنة بدون شهر ويوم.

integer

يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وتكون صالحة للسنة والشهر، أو 0 لتحديد سنة بمفردها أو السنة والشهر حيث لا يكون اليوم كبيرًا.

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

ساعات من اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. وقد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل وقت إغلاق النشاط التجاري.

integer

دقائق من الساعة من اليوم. يجب أن تتراوح القيمة بين 0 و59.

integer

الثواني من الدقائق في الوقت. يجب أن تتراوح في العادة بين 0 و59. وقد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة.

integer

كسور من الثواني بالثواني. يجب أن تتراوح القيمة بين 0 و999,999,999.

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

object (DriveFolder)

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

{
  "choices": [
    string
  ]
}

string

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