- المرجع: دورة تدريبية
- CourseState
- CourseMaterialSet
- CourseMaterial
- GradebookSettings
- CalculationType
- DisplaySetting
- الطُرق
المرجع: دورة تدريبية
دورة تدريبية في Classroom:
تمثيل JSON |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
الحقول | |
---|---|
id |
معرّف هذه الدورة التدريبية الذي تم تعيينه من قِبل Classroom. عند يؤدي تحديد هذا الحقل في قناع تعديل الدورة التدريبية إلى حدوث خطأ. |
name |
تمثّل هذه السمة اسم الدورة التدريبية. على سبيل المثال، "علم الأحياء للصف العاشر". يجب إدخال الاسم. ويجب أن يتراوح عدد الأحرف بين حرف واحد و750 حرفًا وسلسلة UTF-8 صالحة. |
section |
قسم من الدورة التدريبية. على سبيل المثال، "الفترة 2". وفي حال ضبطها، يجب أن يكون هذا الحقل سلسلة UTF-8 صالحة وألا يزيد طولها عن 2800 حرف. |
descriptionHeading |
عنوان اختياري للوصف. على سبيل المثال، "مرحبًا بك في علم الأحياء للصف العاشر". وفي حال ضبطها، يجب أن يكون هذا الحقل سلسلة UTF-8 صالحة وألا يزيد طوله عن 3600 حرف. |
description |
وصف اختياري. على سبيل المثال، "سنتعرف على بنية الكائنات الحية من خلال مجموعة من الكتب الدراسية ومحاضرات الضيوف والأعمال في المختبر. توقع أن تكون متحمسًا!" وفي حال ضبطها، يجب أن يكون هذا الحقل سلسلة UTF-8 صالحة وألا يزيد طوله عن 30,000 حرف. |
room |
الموقع الجغرافي للغرفة اختياري. على سبيل المثال، "301". وفي حال ضبطها، يجب أن يكون هذا الحقل سلسلة UTF-8 صالحة وألا يزيد طوله عن 650 حرفًا. |
ownerId |
تشير هذه السمة إلى معرّف مالك الدورة التدريبية. يكون هذا الحقل مطلوبًا عند تحديده كمَعلمة
يجب ضبط ذلك في طلب إنشاء. يمكن للمشرفين أيضًا تحديد هذا الحقل في |
creationTime |
تمثّل هذه السمة وقت إنشاء الدورة التدريبية. يؤدي تحديد هذا الحقل في قناع تعديل الدورة التدريبية إلى حدوث خطأ. للقراءة فقط. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
updateTime |
تمثّل هذه السمة وقت آخر تعديل على هذه الدورة التدريبية. يؤدي تحديد هذا الحقل في قناع تعديل الدورة التدريبية إلى حدوث خطأ. للقراءة فقط. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
enrollmentCode |
رمز التسجيل الذي سيتم استخدامه عند الانضمام إلى هذه الدورة التدريبية. يؤدي تحديد هذا الحقل في قناع تعديل الدورة التدريبية إلى حدوث خطأ. للقراءة فقط. |
courseState |
تمثّل هذه السمة حالة الدورة التدريبية. وفي حال عدم تحديد الحالة، ستكون الولاية التلقائية هي |
alternateLink |
الرابط الكامل لهذه الدورة التدريبية في واجهة مستخدم الويب في Classroom. للقراءة فقط. |
teacherGroupEmail |
تمثّل هذه السمة عنوان البريد الإلكتروني لمجموعة Google تحتوي على جميع معلّمي الدورة التدريبية. لا تقبل هذه المجموعة تلقّي الرسائل الإلكترونية ويمكن استخدامها للحصول على الأذونات فقط. للقراءة فقط. |
courseGroupEmail |
تمثّل هذه السمة عنوان البريد الإلكتروني لمجموعة Google تحتوي على جميع أعضاء الدورة التدريبية. لا تقبل هذه المجموعة تلقّي الرسائل الإلكترونية ويمكن استخدامها للحصول على الأذونات فقط. للقراءة فقط. |
teacherFolder |
تشير هذه السمة إلى معلومات حول مجلد Drive تتم مشاركتها مع جميع معلّمي الدورة التدريبية. سيتم ضبط هذا الحقل فقط لمعلّمي الدورة التدريبية ومشرفي النطاقات. للقراءة فقط. |
courseMaterialSets[] |
تمثّل هذه السمة مجموعات المواد التي تظهر على صفحة "لمحة" في هذه الدورة التدريبية. للقراءة فقط. |
guardiansEnabled |
ما إذا تم تفعيل إشعارات الأوصياء لهذه الدورة التدريبية أم لا للقراءة فقط. |
calendarId |
رقم تعريف "تقويم Google" لتقويم يمكن لجميع أعضاء الدورة التدريبية الاطّلاع عليه، والذي يضيف إليه Classroom الأحداث الخاصة بالعمل في الدورة التدريبية والإشعارات الخاصة بها في الدورة التدريبية. يتم إنشاء "تقويم Google" لدورة تدريبية بشكل غير متزامن عند ضبط الدورة التدريبية على " للقراءة فقط. |
gradebookSettings |
إعدادات دفتر العلامات التي تحدّد كيفية احتساب الدرجة الإجمالية للطالب في الدورة التدريبية والمستخدمين الذين سيتم عرضها لهم. إذن بالوصول للقراءة فقط |
CourseState
تمثّل هذه السمة الحالات المحتملة التي يمكن أن تكون فيها الدورة التدريبية.
عمليات التعداد | |
---|---|
COURSE_STATE_UNSPECIFIED |
ما مِن حالة للدورة التدريبية. ولن يتم استخدام هذه القيمة في أي رسالة من رسائل دورة تدريبية تم إرجاعها. |
ACTIVE |
الدورة التدريبية نشطة. |
ARCHIVED |
تمت أرشفة الدورة التدريبية. ولا يمكنك تعديلها إلا لتغييرها إلى حالة مختلفة. |
PROVISIONED |
تم إنشاء الدورة التدريبية ولكن لم يتم تفعيلها بعد. يمكن الوصول إلى هذه الأداة من خلال المعلّم الأساسي ومشرفي النطاق، الذين يمكنهم تعديلها أو تغييرها إلى الحالة ACTIVE أو DECLINED . لا يمكن تغيير الدورة التدريبية إلى PROVISIONED إلا إذا كانت في الحالة DECLINED . |
DECLINED |
تم إنشاء الدورة التدريبية ولكن تم رفضها. يمكن لمالك الدورة التدريبية ومشرفي النطاق الوصول إليها، على الرغم من أنه لن يتم عرضها في واجهة مستخدم الويب. لا يمكنك تعديل الدورة التدريبية باستثناء تغييرها إلى الحالة "PROVISIONED ". لا يمكن تغيير الدورة التدريبية إلى DECLINED إلا إذا كانت في الحالة PROVISIONED . |
SUSPENDED |
تم تعليق الدورة التدريبية. لا يمكنك تعديل الدورة التدريبية، ويمكن للمستخدم الذي حدّدته "ownerId " فقط الاطّلاع على الدورة التدريبية. ويمكن وضع هذه الدورة التدريبية في هذه الحالة إذا كان من المحتمل أن تخالف بنود الخدمة. |
CourseMaterialSet
مجموعة من المواد التي تظهر في صفحة "لمحة" في الدورة التدريبية. قد تتضمن هذه المواد المنهج الدراسي أو الجدول الزمني أو معلومات أساسية أخرى تتعلق بالدورة التدريبية ككل.
تمثيل JSON |
---|
{
"title": string,
"materials": [
{
object ( |
الحقول | |
---|---|
title |
عنوان هذه المجموعة |
materials[] |
المواد المرفقة بهذه المجموعة |
CourseMaterial
هي مادة مرفقة بدورة تدريبية كجزء من مجموعة مواد.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد material . بيانات المواد. يمكن أن يكون material واحدًا فقط مما يلي: |
|
driveFile |
مرفق ملف Google Drive. |
youTubeVideo |
مرفق فيديو على YouTube |
link |
سمة الربط |
form |
مرفق في "نماذج Google". |
GradebookSettings
إعدادات دفتر العلامات لدورة تدريبية. يمكنك الاطّلاع على مقالة مركز المساعدة لمعرفة التفاصيل.
تمثيل JSON |
---|
{ "calculationType": enum ( |
الحقول | |
---|---|
calculationType |
يشير إلى كيفية حساب الدرجة الإجمالية. |
displaySetting |
يشير إلى من يمكنه الاطّلاع على الدرجة الإجمالية. |
gradeCategories[] |
فئات الدرجات المتاحة للمهام الدراسية في الدورة التدريبية. |
CalculationType
الطرق الممكنة لحساب الدرجة الكلية.
عمليات التعداد | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
لم يتم تحديد طريقة. ولا يتم إرجاعها مطلقًا. |
TOTAL_POINTS |
الدرجة الإجمالية هي مجموع الدرجات مقسومًا على مجموع النقاط الإجمالية بغض النظر عن الفئة. |
WEIGHTED_CATEGORIES |
الدرجة الإجمالية هي المتوسط المرجح حسب الفئة. |
DisplaySetting
الإعدادات المحتملة لعرض الدرجة الإجمالية.
عمليات التعداد | |
---|---|
DISPLAY_SETTING_UNSPECIFIED |
لم يتم تحديد أي إعداد. ولا يتم إرجاعها مطلقًا. |
SHOW_OVERALL_GRADE |
تعرض الدرجة الإجمالية في دفتر العلامات والملف الشخصي للطالب لكل من المعلمين والطلاب. |
HIDE_OVERALL_GRADE |
لا تعرِض الدرجة الإجمالية في دفتر العلامات أو الملف الشخصي للطالب |
SHOW_TEACHERS_ONLY |
تعرِض الدرجة الإجمالية للمعلّمين في دفتر العلامات والملف الشخصي للطالب. يتم إخفاء هذه المعلومات عن الطلاب في الملف الشخصي للطالب. |
الطُرق |
|
---|---|
|
تعرض هذه السياسة ما إذا كان المستخدم مؤهَّلاً لإنشاء مرفقات الإضافات في دورة تدريبية معيّنة. |
|
تعرِض هذه السمة ما إذا كان المستخدِم مؤهَّلاً لتعديل GradingPeriodSettings في دورة تدريبية معيّنة. |
|
ينشئ دورة تدريبية. |
|
يؤدي هذا الإجراء إلى حذف دورة تدريبية. |
|
تعرض الدورة التدريبية. |
|
تعرض هذه السياسة إعدادات فترة وضع الدرجات في دورة تدريبية. |
|
عرض قائمة بالدورات التدريبية المسموح للمستخدم الذي قدّم الطلب بعرضها، مقتصرة على الدورات التي تتطابق مع الطلب. |
|
لتعديل حقل واحد أو أكثر في دورة تدريبية. |
|
عدِّل دورة تدريبية. |
|
لتعديل إعدادات فترة وضع الدرجات لدورة تدريبية |