REST Resource: courses

المورد: الدورة التدريبية

دورة تعليمية في Classroom

تمثيل JSON 
{
  "id": string,
  "name": string,
  "section": string,
  "descriptionHeading": string,
  "description": string,
  "room": string,
  "ownerId": string,
  "creationTime": string,
  "updateTime": string,
  "enrollmentCode": string,
  "courseState": enum (CourseState),
  "alternateLink": string,
  "teacherGroupEmail": string,
  "courseGroupEmail": string,
  "teacherFolder": {
    object (DriveFolder)
  },
  "courseMaterialSets": [
    {
      object (CourseMaterialSet)
    }
  ],
  "guardiansEnabled": boolean,
  "calendarId": string,
  "gradebookSettings": {
    object (GradebookSettings)
  },
  "subject": string,
  "learningStandardSettings": {
    object (CourseLearningStandardSettings)
  },
  "levels": string
}
الحقول
id

string

معرّف هذه الدورة التدريبية الذي تم تعيينه من قِبل Classroom

عندما يكون creating a course، يمكنك اختياريًا ضبط هذا المعرّف على alias string في طلب إنشاء اسم مستعار مطابق. لا يزال يتم تعيين id من خلال Classroom ولا يمكن تعديله بعد إنشاء الدورة التدريبية.

يؤدي تحديد هذا الحقل في قناع تعديل الدورة التدريبية إلى حدوث خطأ.
name

string

اسم الدورة التدريبية على سبيل المثال، "الصف العاشر: علم الأحياء". يجب إدخال الاسم. يجب أن يتراوح طوله بين حرف واحد و750 حرفًا وأن يكون سلسلة UTF-8 صالحة.
section

string

تمثّل هذه السمة قسم الدورة التدريبية. على سبيل المثال، "الفترة 2". في حال ضبط هذا الحقل، يجب أن يكون سلسلة UTF-8 صالحة وألّا يزيد طوله عن 2, 800 حرف.
descriptionHeading

string

عنوان اختياري للوصف على سبيل المثال، "مرحبًا بكم في مادة الأحياء للصف العاشر". في حال ضبط هذا الحقل، يجب أن يكون سلسلة UTF-8 صالحة وألّا يزيد طوله عن 3, 600 حرف.
description

string

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

string

موقع الغرفة الاختياري على سبيل المثال، "301". في حال ضبطه، يجب أن يكون هذا الحقل سلسلة UTF-8 صالحة وألا يزيد طوله عن 650 حرفًا.
ownerId

string

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

عند تحديد هذا الحقل كمَعلمة لـ create course request، يكون مطلوبًا. يمكن أن يكون المعرّف واحدًا مما يلي:

  • المعرّف الرقمي للمستخدم
  • عنوان البريد الإلكتروني للمستخدم
  • السلسلة الحرفية "me"، التي تشير إلى المستخدم الذي يرسل الطلب

يجب ضبط هذه السمة في طلب إنشاء. يمكن للمشرفين أيضًا تحديد هذا الحقل في patch course request لنقل الملكية. وفي سياقات أخرى، يكون متاحًا للقراءة فقط.
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"
enrollmentCode

string

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

للقراءة فقط.
courseState

enum (CourseState)

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

string

عنوان البريد الإلكتروني لمجموعة Google التي تضم جميع معلّمي الدورة التدريبية لا تقبل هذه المجموعة الرسائل الإلكترونية ويمكن استخدامها للأذونات فقط.

للقراءة فقط.
courseGroupEmail

string

عنوان البريد الإلكتروني لمجموعة Google تضم جميع أعضاء الدورة التدريبية لا تقبل هذه المجموعة الرسائل الإلكترونية ويمكن استخدامها للأذونات فقط.

للقراءة فقط.
teacherFolder

object (DriveFolder)

معلومات عن مجلد Drive تتم مشاركته مع جميع معلّمي الدورة التدريبية

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

للقراءة فقط.
courseMaterialSets[]
(deprecated)

object (CourseMaterialSet)

مجموعات المواد التي تظهر في صفحة "لمحة" لهذه الدورة التدريبية

للقراءة فقط.
guardiansEnabled

boolean

ما إذا تم تفعيل إشعارات الأوصياء لهذه الدورة التدريبية أم لا

للقراءة فقط.
calendarId

string

معرّف التقويم الذي يمكن لجميع أعضاء الدورة التدريبية الاطّلاع عليه، والذي يضيف إليه Classroom أحداثًا للواجب الدراسي والإشعارات في الدورة التدريبية.

يتم إنشاء "تقويم Google" لدورة تدريبية بشكل غير متزامن عند ضبط الدورة التدريبية على CourseState.ACTIVE لأول مرة (في وقت الإنشاء أو عند تعديلها إلى ACTIVE من خلال واجهة المستخدم أو واجهة برمجة التطبيقات). لن تتم تعبئة معرّف التقويم إلا بعد اكتمال عملية الإنشاء.

للقراءة فقط.
gradebookSettings

object (GradebookSettings)

إعدادات دفتر العلامات التي تحدّد كيفية احتساب الدرجة الإجمالية للطالب في الدورة التدريبية والجهات التي سيتم عرضها لها.

للقراءة فقط.
subject

string

اختيارية: موضوع الدورة التدريبية
learningStandardSettings

object (CourseLearningStandardSettings)

اختيارية:

الإعدادات ذات الصلة بمعايير التعلّم المتاحة في الدورة التدريبية يمكن أن تحتوي الدورة التعليمية على 20 جذرًا كحد أقصى لمجموعة معايير التعلّم.
levels

string

اختيارية: مستويات الدورة التدريبية أمثلة: "الصف التاسع"، "المرحلة الإعدادية"، "الصف الرابع - الخامس"، "الروضة - الصف الثاني"، "3000". في حال ضبط هذا الحقل، يجب أن يكون سلسلة UTF-8 صالحة وأقل من 1000 حرف.

لا يمكن محو هذا الحقل إلا باستخدام الطريقة courses.patch.

CourseState

الحالات المحتملة التي يمكن أن تكون فيها الدورة التدريبية.

عمليات التعداد
COURSE_STATE_UNSPECIFIED ما مِن حالة للدورة التدريبية. لن تستخدم أي رسالة Course تم إرجاعها هذه القيمة.
ACTIVE الدورة التدريبية نشطة.
ARCHIVED تمت أرشفة الدورة التدريبية. ولا يمكنك تعديله إلا لتغييره إلى حالة مختلفة.
PROVISIONED تم إنشاء الدورة التدريبية، ولكن لم يتم تفعيلها بعد. ويمكن للمعلّم الأساسي ومشرفي النطاق الوصول إليه، ويمكنهم تعديله أو تغييره إلى الحالة ACTIVE أو DECLINED. لا يمكن تغيير حالة الدورة التدريبية إلى PROVISIONED إلا إذا كانت في الحالة DECLINED.
DECLINED تم إنشاء الدورة التدريبية، ولكن تم رفضها. ويمكن لمالك الدورة التدريبية ومشرفي النطاق الوصول إليها، ولكن لن يتم عرضها في واجهة مستخدم الويب. لا يمكنك تعديل الدورة التدريبية إلا لتغييرها إلى الحالة PROVISIONED. لا يمكن تغيير حالة الدورة التدريبية إلى "DECLINED" إلا إذا كانت في الحالة "PROVISIONED".
SUSPENDED تم تعليق الدورة التدريبية. لا يمكنك تعديل الدورة التدريبية، ويمكن فقط للمستخدم الذي تم تحديده من خلال ownerId عرض الدورة التدريبية. قد يتم وضع دورة تدريبية في هذه الحالة إذا كانت تنتهك بنود الخدمة.

CourseMaterialSet

مجموعة من المواد التي تظهر في صفحة "لمحة" عن الدورة التدريبية قد تتضمن هذه المواد منهجًا دراسيًا أو جدولًا زمنيًا أو معلومات أساسية أخرى تتعلق بالدورة ككل.

تمثيل JSON 
{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}
الحقول
title

string

عنوان هذه المجموعة
materials[]

object (CourseMaterial)

المواد المرفقة بهذه المجموعة

CourseMaterial

مادة مرفقة بدورة تدريبية كجزء من مجموعة مواد

تمثيل JSON 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
الحقول
بيانات المواد في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
driveFile

object (DriveFile)

مرفق ملف Google Drive
youTubeVideo

object (YouTubeVideo)

مرفق فيديو على YouTube
form

object (Form)

مرفق من "نماذج Google"
نهاية الحقول التي يستبعد كلّ منها الآخر

GradebookSettings

إعدادات دفتر العلامات لدورة تدريبية لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة مركز المساعدة.

تمثيل JSON 
{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}
الحقول
calculationType

enum (CalculationType)

يشير إلى كيفية احتساب الدرجة الإجمالية.
displaySetting

enum (DisplaySetting)

يشير هذا الحقل إلى المستخدمين الذين يمكنهم الاطّلاع على الدرجة الإجمالية.
gradeCategories[]

object (GradeCategory)

فئات تقسيم الدرجات المتاحة للمواد التعليمية في الدورة التعليمية

CalculationType

الطرق الممكنة لاحتساب الدرجة الإجمالية

عمليات التعداد
CALCULATION_TYPE_UNSPECIFIED لم يتم تحديد أي طريقة. ولا يتم عرض هذه القيمة مطلقًا.
TOTAL_POINTS الدرجة الكلية هي مجموع الدرجات مقسومًا على مجموع النقاط الإجمالية بغض النظر عن الفئة.
WEIGHTED_CATEGORIES الدرجة الإجمالية هي المتوسط المرجّح حسب الفئة.

DisplaySetting

الإعدادات الممكنة لعرض الدرجة الإجمالية

عمليات التعداد
DISPLAY_SETTING_UNSPECIFIED لم يتم تحديد أي إعداد. ولا يتم عرض هذه القيمة مطلقًا.
SHOW_OVERALL_GRADE يعرض الدرجة الإجمالية في دفتر العلامات والملف الشخصي للطالب لكل من المعلّمين والطلاب.
HIDE_OVERALL_GRADE لا تظهر الدرجة الإجمالية في دفتر العلامات أو ملف الطالب الشخصي.
SHOW_TEACHERS_ONLY يعرض الدرجة الإجمالية للمعلّمين في دفتر العلامات والملف الشخصي للطالب. يتم إخفاء هذه المعلومات عن الطلاب في ملفاتهم الشخصية.

CourseLearningStandardSettings

إعدادات مجموعة معايير التعلّم لدورة تعليمية

تمثيل JSON 
{
  "standardSets": [
    {
      object (LearningStandardSetRoot)
    }
  ]
}
الحقول
standardSets[]

object (LearningStandardSetRoot)

الحقل مطلوب. مجموعة جذور معايير التعلّم المطبَّقة على هذه الدورة التعليمية

LearningStandardSetRoot

يمثّل جذر مجموعة محدّدة من معايير التعلّم. ستظهر العناصر الفرعية للجذور المحدّدة عند ضبط أهداف التعلّم على عناصر ساحة المشاركات في واجهة مستخدم Classroom.

تمثيل JSON 
{
  "caseGuid": {
    object (CaseGuid)
  },
  "documentTitle": string,
  "standardTitle": string,
  "sourceDataAvailabilityStatus": enum (LearningStandardAvailabilityState)
}
الحقول
caseGuid

object (CaseGuid)

الحقل مطلوب. معرّف GUID الخاص بـ Satchel Rosetta Exchange لجذر مجموعة معايير التعلّم.
documentTitle

string

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

string

النتائج فقط. تمثّل هذه السمة عنوان جذر مجموعة معايير التعلّم.
sourceDataAvailabilityStatus

enum (LearningStandardAvailabilityState)

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

الطُرق

checkAddOnCreationEligibility
(deprecated)

 تعرض هذه الطريقة ما إذا كان المستخدم مؤهلاً لإنشاء مرفقات الإضافات في دورة تدريبية معيّنة.

checkGradingPeriodsSetupEligibility
(deprecated)

 تعرض ما إذا كان المستخدم مؤهلاً لتعديل GradingPeriodSettings في دورة تدريبية معيّنة.

create

 لإنشاء دورة تدريبية

delete

 لحذف دورة تدريبية

get

 لعرض دورة تدريبية

getGradingPeriodSettings

 تعرض هذه الطريقة إعدادات فترة وضع الدرجات في دورة دراسية.

list

 تعرض هذه الطريقة قائمة بالدورات التدريبية التي يُسمح للمستخدم الذي يطلبها بالاطّلاع عليها، وتقتصر على تلك التي تتطابق مع الطلب.

patch

 لتعديل حقل واحد أو أكثر في دورة تدريبية

update

 تعديل دورة تدريبية

updateGradingPeriodSettings

 تعديل إعدادات فترة وضع الدرجات في دورة تدريبية