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

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

رقم تعريف التقويم لتقويم يمكن لجميع أعضاء الدورة التدريبية الاطّلاع عليه، ويضيف 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)

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