REST Resource: courses

{
  "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)
  }
}

string

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

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

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

string

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

string

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

string

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

string

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

string

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

string

تشير هذه السمة إلى معرّف مالك الدورة التدريبية.

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

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

يجب ضبط ذلك في طلب إنشاء. يمكن للمشرفين أيضًا تحديد هذا الحقل في patch course request لنقل الملكية. وفي سياقات أخرى، يكون الحقل للقراءة فقط.

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".

string

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

للقراءة فقط.

enum (CourseState)

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

string

الرابط الكامل لهذه الدورة التدريبية في واجهة مستخدم الويب في Classroom.

للقراءة فقط.

string

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

للقراءة فقط.

string

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

للقراءة فقط.

object (DriveFolder)

تشير هذه السمة إلى معلومات حول مجلد Drive تتم مشاركتها مع جميع معلّمي الدورة التدريبية.

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

للقراءة فقط.

object (CourseMaterialSet)

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

للقراءة فقط.

boolean

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

للقراءة فقط.

string

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

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

للقراءة فقط.

object (GradebookSettings)

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

إذن بالقراءة فقط

{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}

string

عنوان هذه المجموعة

object (CourseMaterial)

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

{

  // Union field material can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field material.
}

object (DriveFile)

مرفق ملف Google Drive.

object (YouTubeVideo)

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

object (Link)

سمة الربط

object (Form)

مرفق في "نماذج Google".

{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}

enum (CalculationType)

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

enum (DisplaySetting)

يشير إلى من يمكنه الاطّلاع على الدرجة الإجمالية.

object (GradeCategory)

فئات الدرجات المتاحة للمهام الدراسية في الدورة التدريبية.