REST Resource: courses

Kaynak: Kurs

Classroom'da bir kurs.

JSON gösterimi 
{
  "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)
  }
}
Alanlar
id

string

Classroom tarafından atanan bu dersin tanımlayıcısıdır.

creating a course olduğunda, isteğe bağlı olarak bu tanımlayıcıyı ilgili bir takma ad oluşturmak için alias string olarak ayarlayabilirsiniz. id, Classroom tarafından atanmaya devam eder ve kurs oluşturulduktan sonra güncellenemez.

Bu alanın bir kurs güncelleme maskesinde belirtilmesi hatayla sonuçlanır.
name

string

Kursun adı. Örneğin, "10. Sınıf Biyoloji". Ad gerekli. 1 ila 750 karakter uzunluğunda ve geçerli bir UTF-8 dizesi olmalıdır.
section

string

Kursun bölümü. Örneğin, "Dönem 2". Ayarlanırsa bu alan geçerli bir UTF-8 dizesi olmalı ve 2.800 karakterden uzun olmamalıdır.
descriptionHeading

string

Açıklama için isteğe bağlı başlık. Örneğin, "10. Sınıf Biyoloji'ye Hoş Geldiniz." Ayarlanmışsa bu alan geçerli bir UTF-8 dizesi olmalı ve 3.600 karakterden uzun olmamalıdır.
description

string

İsteğe bağlı açıklama. Örneğin, "Öğrencilerimiz, ders kitapları, konuk konferansları ve laboratuvar çalışmaları aracılığıyla canlı organizmaların yapısı hakkında bilgi edinecek. Heyecanlanacaksınız." Ayarlanırsa bu alan geçerli bir UTF-8 dizesi olmalı ve 30.000 karakterden uzun olmamalıdır.
room

string

İsteğe bağlı oda konumu. Örneğin, "301". Ayarlanmışsa bu alan geçerli bir UTF-8 dizesi olmalı ve 650 karakterden uzun olmamalıdır.
ownerId

string

Bir dersin sahibinin tanımlayıcısıdır.

Bir create course request parametresi olarak belirtildiğinde bu alan zorunludur. Tanımlayıcı aşağıdakilerden biri olabilir:

  • kullanıcının sayısal tanımlayıcısıdır.
  • kullanıcının e-posta adresi
  • İstekte bulunan kullanıcıyı belirten "me" değişmez dizesi

Bu, bir oluşturma isteğinde ayarlanmalıdır. Yöneticiler, sahipliği aktarmak için patch course request içinde bu alanı da belirtebilir. Diğer bağlamlarda salt okunurdur.
creationTime

string (Timestamp format)

Kursun oluşturulma zamanı. Bu alanın bir kurs güncelleme maskesinde belirtilmesi hatayla sonuçlanır.

Salt okunur.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Bu kursta yapılan en son güncellemenin zamanı. Bu alanın bir kurs güncelleme maskesinde belirtilmesi hatayla sonuçlanır.

Salt okunur.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
enrollmentCode

string

Bu kursa katılırken kullanılacak kayıt kodu. Bu alanın bir kurs güncelleme maskesinde belirtilmesi hatayla sonuçlanır.

Salt okunur.
courseState

enum (CourseState)

Kursun durumu. Belirtilmemişse varsayılan durum PROVISIONED olur.
teacherGroupEmail

string

Kursun tüm öğretmenlerini içeren bir Google grubunun e-posta adresi. Bu grup e-posta kabul etmez ve yalnızca izinler için kullanılabilir.

Salt okunur.
courseGroupEmail

string

Kursun tüm üyelerini içeren bir Google grubunun e-posta adresi. Bu grup e-posta kabul etmez ve yalnızca izinler için kullanılabilir.

Salt okunur.
teacherFolder

object (DriveFolder)

Kursun tüm öğretmenleriyle paylaşılan bir Drive klasörü hakkında bilgi.

Bu alan yalnızca kursun öğretmenleri ve alan yöneticileri için ayarlanır.

Salt okunur.
courseMaterialSets[]
(deprecated)

object (CourseMaterialSet)

Bu dersin "hakkında" sayfasında görünen materyal grupları.

Salt okunur.
guardiansEnabled

boolean

Bu kurs için veli bildirimlerinin etkinleştirilip etkinleştirilmediği.

Salt okunur.
calendarId

string

Tüm kurs üyelerinin görebileceği bir takvimin Takvim kimliği. Classroom, bu takvime kurs çalışmaları ve kurstaki duyurularla ilgili etkinlikler ekler.

Bir dersin takvimi, ders ilk kez CourseState.ACTIVE olarak ayarlandığında (oluşturma sırasında veya kullanıcı arayüzü ya da API aracılığıyla ACTIVE olarak güncellendiğinde) eşzamansız olarak oluşturulur. Oluşturma işlemi tamamlanana kadar Takvim Kimliği doldurulmaz.

Salt okunur.
gradebookSettings

object (GradebookSettings)

Bir öğrencinin kurstaki genel notunun nasıl hesaplanacağını ve kime gösterileceğini belirten not defteri ayarları.

Salt okunur

CourseState

Bir dersin bulunabileceği olası durumlar.

Sıralamalar
COURSE_STATE_UNSPECIFIED Kurs durumu yok. Döndürülen hiçbir Kurs mesajı bu değeri kullanmaz.
ACTIVE Kurs etkin olmalıdır.
ARCHIVED Ders arşivlendi. Farklı bir duruma ayarlamak dışında değiştiremezsiniz.
PROVISIONED Kurs oluşturuldu ancak henüz etkinleştirilmedi. Birincil öğretmen ve alan yöneticileri bu sayfaya erişebilir. Bu sayfayı değiştirebilir veya ACTIVE ya da DECLINED durumlarından birine ayarlayabilir. Bir kurs yalnızca DECLINED durumundayken PROVISIONED olarak değiştirilebilir.
DECLINED Kurs oluşturuldu ancak reddedildi. Web kullanıcı arayüzünde gösterilmese de kurs sahibi ve alan yöneticileri tarafından erişilebilir. Kursu, PROVISIONED durumuna değiştirmek dışında değiştiremezsiniz. Bir kurs yalnızca PROVISIONED durumundayken DECLINED olarak değiştirilebilir.
SUSPENDED Ders askıya alındı. Kursu değiştiremezsiniz ve yalnızca ownerId ile tanımlanan kullanıcı kursu görüntüleyebilir. Hizmet Şartları'nı ihlal etme ihtimali olan kurslar bu duruma geçirilebilir.

CourseMaterialSet

Kursun "Hakkında" sayfasında görünen bir dizi materyal. Bu materyaller arasında müfredat, program veya kursla ilgili diğer arka plan bilgileri yer alabilir.

JSON gösterimi 
{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}
Alanlar
title

string

Bu grubun başlığı.
materials[]

object (CourseMaterial)

Bu gruba eklenen materyaller.

CourseMaterial

Bir materyal grubunun parçası olarak bir kursa eklenen materyal.

JSON gösterimi 
{

  // 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.
}
Alanlar
Birlik alanı material. Malzeme verileri. material yalnızca aşağıdakilerden biri olabilir:
driveFile

object (DriveFile)

Google Drive dosyası eki.
youTubeVideo

object (YouTubeVideo)

YouTube videosu eki.
form

object (Form)

Google Formlar eki.

GradebookSettings

Bir dersin not defteri ayarları. Ayrıntılar için Yardım Merkezi makalesini inceleyin.

JSON gösterimi 
{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}
Alanlar
calculationType

enum (CalculationType)

Genel notun nasıl hesaplandığını gösterir.
displaySetting

enum (DisplaySetting)

Genel notu kimlerin görebileceğini belirtir.
gradeCategories[]

object (GradeCategory)

Kurstaki sınıf çalışmaları için kullanılabilen not kategorileri.

CalculationType

Genel not hesaplama yöntemleri.

Sıralamalar
CALCULATION_TYPE_UNSPECIFIED Yöntem belirtilmedi. Bu bilgiler hiçbir zaman geri gönderilmez.
TOTAL_POINTS Genel not, notların toplamının kategoriye bakılmaksızın toplam puanların toplamına bölünmesiyle elde edilir.
WEIGHTED_CATEGORIES Genel not, kategoriye göre ağırlıklı ortalamadır.

DisplaySetting

Genel notu görüntülemeyle ilgili olası ayarlar.

Sıralamalar
DISPLAY_SETTING_UNSPECIFIED Herhangi bir ayar belirtilmedi. Bu bilgiler hiçbir zaman geri gönderilmez.
SHOW_OVERALL_GRADE Not defterinde ve öğrenci profilinde genel notu hem öğretmenlere hem de öğrencilere gösterir.
HIDE_OVERALL_GRADE Not defteri veya öğrenci profilinde genel not gösterilmez.
SHOW_TEACHERS_ONLY Not defterinde ve öğrenci profilinde öğretmenlere genel notu gösterir. Öğrenci profilinde öğrencilerden gizlenir.

Yöntemler

checkAddOnCreationEligibility
(deprecated)

 Kullanıcının belirli bir kursta eklenti eki oluşturmaya uygun olup olmadığını döndürür.

checkGradingPeriodsSetupEligibility
(deprecated)

 Kullanıcının belirli bir kurstaki GradingPeriodSettings ayarlarını güncellemeye uygun olup olmadığını döndürür.

create

 Kurs oluşturur.

delete

 Bir dersi siler.

get

 Bir kurs döndürür.

getGradingPeriodSettings

 Bir kurstaki notlandırma dönemi ayarlarını döndürür.

list

 İstekte bulunan kullanıcının görüntülemesine izin verilen kursların listesini döndürür. Bu liste, istekle eşleşen kurslarla sınırlıdır.

patch

 Bir kurstaki bir veya daha fazla alanı günceller.

update

 Bir dersi günceller.

updateGradingPeriodSettings

 Bir dersin notlandırma dönemi ayarlarını günceller.