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 باشد و بیش از 30000 کاراکتر نباشد.

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 رویدادهایی را برای کار دوره و اطلاعیه‌های دوره به آن اضافه می‌کند.

هنگامی که دوره برای اولین بار روی CourseState.ACTIVE تنظیم می شود (در زمان ایجاد یا زمانی که از طریق UI یا API به 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 )

پیوست ویدیوی یوتیوب.

object ( Link )

پیوست پیوند.

object ( Form )

پیوست Google Forms.

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

enum ( CalculationType )

نشان می دهد که چگونه نمره کلی محاسبه می شود.

enum ( DisplaySetting )

نشان می دهد چه کسی می تواند نمره کلی را ببیند..

object ( GradeCategory )

دسته بندی های درسی که برای دوره های آموزشی در دسترس هستند.