REST Resource: courses

Kaynak: Kurs

Classroom'da kurs oluşturma

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)
  },
  "subject": string,
  "learningStandardSettings": {
    object (CourseLearningStandardSettings)
  },
  "levels": string
}
Alanlar
id

string

Classroom tarafından bu kursa atanan tanımlayıcı.

creating a course sırasında, isteğe bağlı olarak bu tanımlayıcıyı, karşılık gelen bir takma ad oluşturma isteğinde 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 ile 750 karakter arasında olmalı ve geçerli bir UTF-8 dizesi olmalıdır.
section

string

Kursun bölümü. Örneğin, "2. Dönem". 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 Dersi'ne Hoş Geldiniz." Ayarlanırsa 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, "Canlıların yapısını ders kitapları, konuk öğretim üyelerinin dersleri ve laboratuvar çalışmalarıyla öğreneceğiz. Heyecanlanmaya hazır olun." 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". Ayarlanırsa bu alan, geçerli bir UTF-8 dizesi olmalı ve 650 karakterden uzun olmamalıdır.
ownerId

string

Kurs sahibinin tanımlayıcısı.

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ı
  • Kullanıcının e-posta adresi
  • İstekte bulunan kullanıcıyı belirten "me" değişmez dizesi

Bu, oluşturma isteğinde ayarlanmalıdır. Yöneticiler, sahipliği aktarmak için bu alanı patch course request içinde de belirtebilir. Diğer bağlamlarda ise 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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üyle ilgili bilgiler.

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

Salt okunur.
courseMaterialSets[]
(deprecated)

object (CourseMaterialSet)

Bu kursun "Hakkında" sayfasında gösterilen materyal setleri.

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, Classroom'un kurs çalışmaları ve duyurular için etkinlik eklediği takvimin takvim kimliği.

Bir kursun takvimi, kurs 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. Takvim kimliği, oluşturma işlemi tamamlanana kadar doldurulmaz.

Salt okunur.
gradebookSettings

object (GradebookSettings)

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

Salt okunur.
subject

string

İsteğe bağlı. Kursun konusu.
learningStandardSettings

object (CourseLearningStandardSettings)

İsteğe bağlı.

Kursta bulunan öğrenme standartlarıyla ilgili ayarlar. Bir kursa en fazla 5 öğrenme standardı seti kökü atanabilir.
levels

string

İsteğe bağlı. Kursun seviyeleri. Örnekler: "9. sınıf", "Ortaokul", "4. - 5.", "K-2", "3000". Ayarlanırsa bu alan geçerli bir UTF-8 dizesi olmalı ve 1.000 karakterden kısa olmalıdır.

Bu alan yalnızca courses.patch yöntemi kullanılarak temizlenebilir.

CourseState

Bir kursun olası durumları.

Sıralamalar
COURSE_STATE_UNSPECIFIED Kurs durumu yok. Döndürülen hiçbir Course mesajında bu değer kullanılmaz.
ACTIVE Kurs etkin olmalıdır.
ARCHIVED Kurs arşivlendi. Bu kimliği, farklı bir eyaletle değiştirmek dışında düzenleyemezsiniz.
PROVISIONED Kurs oluşturuldu ancak henüz etkinleştirilmedi. Birincil öğretmen ve alan yöneticileri bu dosyaya erişebilir, dosyayı değiştirebilir veya ACTIVE ya da DECLINED durumuna getirebilir. Bir kurs yalnızca DECLINED durumundaysa 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 bu özelliğe erişebilir. Kursu PROVISIONED durumuna getirmek dışında değiştiremezsiniz. Bir kurs yalnızca PROVISIONED durumundaysa DECLINED olarak değiştirilebilir.
SUSPENDED Kurs askıya alındı. Kursu değiştiremezsiniz ve kursu yalnızca ownerId tarafından tanımlanan kullanıcı görüntüleyebilir. Bir kurs, Hizmet Şartları'nı ihlal etme ihtimali varsa bu duruma getirilebilir.

CourseMaterialSet

Kursun "Hakkında" sayfasında gösterilen materyaller. Bu materyaller arasında ders programı, takvim veya kursun tamamıyla 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 sete eklenen materyaller.

CourseMaterial

Bir materyal setinin parçası olarak kursa eklenen materyal.

JSON gösterimi 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
Alanlar
material birleşik alanı. Materyal verileri. material aşağıdakilerden yalnızca biri olabilir:
driveFile

object (DriveFile)

Google Drive dosyası eki.
youTubeVideo

object (YouTubeVideo)

YouTube video eki.
form

object (Form)

Google Formlar eki.

GradebookSettings

Bir dersin not defteri ayarları. Ayrıntılı bilgi 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 çalışma materyalleri için kullanılabilen not kategorileri.

CalculationType

Genel not hesaplaması için olası yöntemler.

Sıralamalar
CALCULATION_TYPE_UNSPECIFIED Yöntem belirtilmedi. Bu değer hiçbir zaman döndürülmez.
TOTAL_POINTS Genel not, kategoriden bağımsız olarak notların toplamının toplam puanların toplamına bölünmesiyle hesaplanır.
WEIGHTED_CATEGORIES Genel not, kategoriye göre ağırlıklı ortalamadır.

DisplaySetting

Genel notu görüntülemek için olası ayarlar.

Sıralamalar
DISPLAY_SETTING_UNSPECIFIED Ayarlanacak bir özellik belirtilmedi. Bu değer hiçbir zaman döndürülmez.
SHOW_OVERALL_GRADE Hem öğretmenlere hem de öğrencilere not defterinde ve öğrenci profilinde genel notu gösterir.
HIDE_OVERALL_GRADE Not defterinde veya öğrenci profilinde genel not gösterilmez.
SHOW_TEACHERS_ONLY Genel notu not defterinde ve öğrenci profilinde öğretmenlere gösterir. Öğrenci profillerinde öğrencilerden gizlenir.

CourseLearningStandardSettings

Bir kursun öğrenme standardı ayarları.

JSON gösterimi 
{
  "standardSets": [
    {
      object (LearningStandardSetRoot)
    }
  ]
}
Alanlar
standardSets[]

object (LearningStandardSetRoot)

Zorunlu. Bu kursa uygulanan öğrenme standardı kökleri grubu.

LearningStandardSetRoot

Seçilen bir öğrenim standardı grubunun kökünü temsil eder. Classroom kullanıcı arayüzündeki akış öğelerinde öğrenim hedefleri belirlenirken seçilen köklerin alt öğeleri gösterilir.

JSON gösterimi 
{
  "caseGuid": {
    object (CaseGuid)
  },
  "documentTitle": string,
  "standardTitle": string,
  "sourceDataAvailabilityStatus": enum (LearningStandardAvailabilityState)
}
Alanlar
caseGuid

object (CaseGuid)

Zorunlu. Bir öğrenme standardı seti kökü için Satchel Rosetta Exchange GUID'si.
documentTitle

string

Yalnızca çıkış. Öğrenme standartları seti kökünün belge başlığı.
standardTitle

string

Yalnızca çıkış. Öğrenme standardı seti kökünün başlığı.
sourceDataAvailabilityStatus

enum (LearningStandardAvailabilityState)

Yalnızca çıkış. Öğrenme standardı seti kökünün kullanılabilirlik durumu. Öğrenme standartları set kökünün kaynaktan silinip silinmediğini belirlemek için bunu kullanın.

Yöntemler

checkAddOnCreationEligibility
(deprecated)

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

checkGradingPeriodsSetupEligibility
(deprecated)

 Kullanıcının belirli bir kursta GradingPeriodSettings'i güncellemeye uygun olup olmadığını döndürür.

create

 Kurs oluşturur.

delete

 Kursu 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

 Kursu günceller.

updateGradingPeriodSettings

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