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 في الطلب لإنشاء اسم مستعار مطابق. لا يزال يتم تعيين id من خلال Classroom ولا يمكن تعديله بعد إنشاء الدورة التدريبية.

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

string

اسم الدورة التدريبية. على سبيل المثال، "علم الأحياء للصف العاشر". يجب إدخال الاسم. يجب أن يتكوّن من بين 1 و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 "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"

string

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

للقراءة فقط.

enum (CourseState)

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

string

رابط مطلق إلى هذه الدورة التدريبية في واجهة مستخدم الويب في Classroom

للقراءة فقط.

string

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

للقراءة فقط.

string

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

للقراءة فقط.

object (DriveFolder)

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

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

للقراءة فقط.

object (CourseMaterialSet)

تمثّل هذه السمة مجموعات المواد التي تظهر على صفحة "لمحة" في هذه الدورة التدريبية.

للقراءة فقط.

boolean

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

للقراءة فقط.

string

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

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

للقراءة فقط.

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)

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