REST Resource: courses.courseWorkMaterials

Kaynak: CourseWorkMaterial

Öğretmen tarafından dersin öğrencileri için oluşturulan sınıf çalışması materyali

JSON gösterimi
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": string
}
Alanlar
courseId

string

Kursun tanımlayıcısı.

Salt okunur.

id

string

Bu sınıf çalışması materyalinin, sınıfta atanan ve ders başına benzersiz olan tanımlayıcısı.

Salt okunur.

title

string

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

description

string

Bu kurs çalışması materyalinin isteğe bağlı açıklaması. Metin,30.000 karakterden uzun olmayan geçerli bir UTF-8 dizesi olmalıdır.

materials[]

object (Material)

Ek materyaller.

Bir ödev materyalinde en fazla 20 materyal öğesi bulunmalıdır.

state

enum (CourseWorkMaterialState)

Bu ders materyalinin durumu. Belirtilmemişse varsayılan durum DRAFT olur.

creationTime

string (Timestamp format)

Bu sınıf çalışması materyalinin oluşturulduğu zamanı gösteren zaman damgası.

Salt okunur.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat 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 kurs çalışması materyalinde yapılan en son değişikliğin zaman damgası.

Salt okunur.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

scheduledTime

string (Timestamp format)

Bu sınıf çalışması materyalinin yayınlanması planlandığında isteğe bağlı olarak zaman damgası ekleyebilirsiniz.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

assigneeMode

enum (AssigneeMode)

Sınıf çalışması materyalinin atanan modu. Belirtilmediği takdirde varsayılan değer ALL_STUDENTS olur.

individualStudentsOptions

object (IndividualStudentsOptions)

Kurs materyaline erişimi olan öğrencilerin tanımlayıcıları. Bu alan yalnızca assigneeMode INDIVIDUAL_STUDENTS ise ayarlanır. assigneeMode simgesi INDIVIDUAL_STUDENTS ise yalnızca bu alanda belirtilen öğrenciler kurs çalışması materyalini görebilir.

creatorUserId

string

Sınıf çalışması materyalini oluşturan kullanıcının tanımlayıcısı.

Salt okunur.

topicId

string

Bu sınıf çalışması materyalinin ilişkili olduğu konunun tanımlayıcısı. Kurstaki mevcut bir konuyla eşleşmelidir.

CourseWorkMaterialState

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

Sıralamalar
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Eyalet belirtilmedi. Bu değer hiçbir zaman döndürülmez.
PUBLISHED Yayınlanmış sınıf çalışması materyalinin durumu. Bu, varsayılan durumdur.
DRAFT Henüz yayınlanmamış bir sınıf çalışması materyalinin durumu. Bu durumdaki sınıf çalışması materyali yalnızca kurs öğretmenleri ve alan yöneticileri tarafından görülebilir.
DELETED Yayınlanmış ancak silinmiş sınıf çalışması materyalinin durumu. Bu durumdaki sınıf çalışması materyali yalnızca kurs öğretmenleri ve alan yöneticileri tarafından görülebilir. Bu durumdaki kurs çalışması materyali bir süre sonra silinir.

Yöntemler

create

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

delete

Ders materyalini siler.

get

Bir kurs çalışması materyali döndürür.

getAddOnContext

Belirli bir gönderi bağlamında Classroom eklentilerinin meta verilerini alır.

list

İstekte bulunan kullanıcının görüntülemesine izin verilen kurs materyallerinin listesini döndürür.

patch

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