REST Resource: courses.courseWork

Kaynak: CourseWork

Dersin öğrencileri için bir öğretmen tarafından oluşturulan sınıf çalışması.

JSON gösterimi
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "gradingPeriodId": string
}
Alanlar
courseId

string

Kursun tanımlayıcısı.

Salt okunur.

id

string

Bu sınıf çalışmasının Classroom tarafından atanan tanımlayıcısı (her ders için benzersizdir).

Salt okunur.

title

string

Bu sınıf çalışmasının başlığı. Başlık, 1 ile 3.000 karakter arasında geçerli bir UTF-8 dizesi olmalıdır.

description

string

Bu sınıf çalışmasının isteğe bağlı açıklaması. Ayarlanırsa açıklama en fazla 30.000 karakter içeren geçerli bir UTF-8 dizesi olmalıdır.

materials[]

object (Material)

Ek materyaller.

CourseWork'te en fazla 20 malzeme öğesi bulunabilir.

state

enum (CourseWorkState)

Bu sınıf çalışmasının durumu. Belirtilmemişse varsayılan durum DRAFT olur.

creationTime

string (Timestamp format)

Bu kurs çalışmasının oluşturulduğu zaman damgası.

Salt okunur.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Bu sınıf çalışmasında yapılan en son değişikliğin zaman damgası.

Salt okunur.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

dueDate

object (Date)

Bu sınıf çalışması için gönderilen isteğe bağlı tarih (UTC). dueTime belirtilmişse bu değer de belirtilmelidir.

dueTime

object (TimeOfDay)

Bu kurs çalışması için gönderimlerin teslim edilmesi gereken isteğe bağlı saat (UTC). dueDate belirtilmişse bu değer de belirtilmelidir.

scheduledTime

string (Timestamp format)

Bu kurs çalışmasının yayınlanmasının planlandığı isteğe bağlı zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

maxPoints

number

Bu sınıf çalışması için maksimum not. Ödev sıfırsa veya belirtilmemişse bu ödev not verilmemiş olarak kabul edilir. Negatif olmayan bir tam sayı olmalıdır.

workType

enum (CourseWorkType)

Bu sınıf çalışmasının türü.

Tür, sınıf çalışması oluşturulduğunda ayarlanır ve değiştirilemez.

associatedWithDeveloper

boolean

Bu kurs çalışması öğesinin, istekte bulunan Geliştirici Konsolu projesiyle ilişkili olup olmadığı.

Ayrıntılı bilgi için courseWork.create sayfasını inceleyin.

Salt okunur.

assigneeMode

enum (AssigneeMode)

Sınıf çalışmasının atanan modu. Bir değer belirtilmediyse varsayılan değer ALL_STUDENTS olur.

individualStudentsOptions

object (IndividualStudentsOptions)

Sınıf çalışmasına erişimi olan öğrencilerin tanımlayıcıları. Bu alan yalnızca assigneeMode, INDIVIDUAL_STUDENTS ise ayarlanır. assigneeMode değeri INDIVIDUAL_STUDENTS ise yalnızca bu alanda belirtilen öğrencilere sınıf çalışması atanır.

submissionModificationMode

enum (SubmissionModificationMode)

Öğrencilerin gönderimleri ne zaman değiştirebileceğini belirleyen ayar. Bir değer belirtilmediyse varsayılan değer MODIFIABLE_UNTIL_TURNED_IN olur.

creatorUserId

string

Sınıf çalışmasını oluşturan kullanıcının kimliği.

Salt okunur.

topicId

string

Bu kurs çalışmasının ilişkilendirildiği konunun tanımlayıcısı. Dersteki mevcut bir konuyla eşleşmelidir.

gradeCategory

object (GradeCategory)

Bu sınıf çalışması notunun katkıda bulunduğu kategori. Yalnızca sınıf çalışması için bir kategori seçildiğinde gösterilir. Genel not hesaplamasında kullanılabilir.

Salt okunur.

previewVersion

enum (PreviewVersion)

Yalnızca çıkış. Bu kaynağı almak için kullanılan API'nin önizleme sürümü.

Birleştirme alanı details. Sınıf çalışması türüne özel ek ayrıntılar. details şunlardan yalnızca biri olabilir:
assignment

object (Assignment)

Atama ayrıntıları. Bu alan yalnızca workType, ASSIGNMENT olduğunda doldurulur.

Salt okunur.

multipleChoiceQuestion

object (MultipleChoiceQuestion)

Çoktan seçmeli sorunun ayrıntıları. Okuma işlemlerinde bu alan yalnızca workType, MULTIPLE_CHOICE_QUESTION olduğunda doldurulur. Yazma işlemleri için bu alan, MULTIPLE_CHOICE_QUESTION workType ile sınıf çalışması oluştururken belirtilmelidir ve aksi şekilde ayarlanmamalıdır.

gradingPeriodId

string

Sınıf çalışmasıyla ilişkili notlandırma döneminin tanımlayıcısı.

  • Belirtilmemesi durumunda notlandırma dönemi kimliği, dueDate öğesine (veya dueDate ayarlanmamışsa scheduledTime) göre ayarlanır.
  • Herhangi bir notlandırma dönemiyle ilişkilendirme olmadığını belirtmek için bu alanı boş bir dizeye ("") ayarlayın.
  • Belirtilmişse dersteki mevcut bir notlandırma dönemi kimliğiyle eşleşmelidir.

CourseWorkState

Sınıf çalışmasının olası durumları.

Sıralamalar
COURSE_WORK_STATE_UNSPECIFIED Eyalet belirtilmedi. Bu bilgi hiçbir zaman döndürülmez.
PUBLISHED Yayınlanan çalışmaların durumu. Bu, varsayılan durumdur.
DRAFT Henüz yayınlanmamış çalışmaların durumu. Bu durumdaki çalışmalar yalnızca ders öğretmenleri ve alan yöneticileri tarafından görülebilir.
DELETED Yayınlanan ancak silinmiş olan çalışmaların durumu. Bu durumdaki çalışmalar yalnızca ders öğretmenleri ve alan yöneticileri tarafından görülebilir. Bu durumdaki çalışmalar bir süre sonra silinir.

SubmissionModificationMode

Öğrenci gönderimleri için olası değişiklik modları.

Sıralamalar
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Değişiklik modu belirtilmedi. Bu bilgi hiçbir zaman döndürülmez.
MODIFIABLE_UNTIL_TURNED_IN Gönderimler teslim edilmeden önce değiştirilebilir.
MODIFIABLE Gönderimler herhangi bir zamanda değiştirilebilir.

Ödev

Atamalarla ilgili ek ayrıntılar.

JSON gösterimi
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Alanlar
studentWorkFolder

object (DriveFolder)

Öğrenci gönderimlerindeki eklerin yerleştirildiği Drive klasörü. Bu alan yalnızca ders öğretmenleri ve yöneticileri için doldurulur.

MultipleChoiceQuestion

Çoktan seçmeli sorular için ek ayrıntılar.

JSON gösterimi
{
  "choices": [
    string
  ]
}
Alanlar
choices[]

string

Olası seçenekler.

Yöntemler

create

Sınıf çalışması oluşturur.

delete

Sınıf çalışmasını siler.

get

Sınıf çalışmasını geri verir.

getAddOnContext

Belirli bir yayının bağlamında Classroom eklentilerinin meta verilerini alır.

list

İstekte bulunan kişinin görüntülemesine izin verilen sınıf çalışmalarının listesini döndürür.

modifyAssignees

Atananlar modunu ve sınıf çalışmasının seçeneklerini değiştirir.

patch

Bir sınıf çalışmasının bir veya daha fazla alanını günceller.