REST Resource: courses.announcements

Kaynak: Duyuru

Öğretmen tarafından kurs öğrencileri için oluşturulan duyuru

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

string

Kursun tanımlayıcısı.

Salt okunur.
id

string

Bu duyuruya Classroom tarafından atanan ve kursa özel olan tanımlayıcı.

Salt okunur.
text

string

Bu duyurunun açıklaması. Metin,30.000 karakterden uzun olmayan geçerli bir UTF-8 dizesi olmalıdır.
materials[]

object (Material)

Ek materyaller.

Duyurular en fazla 20 materyal öğesi içermelidir.
state

enum (AnnouncementState)

Bu duyurunun durumu. Belirtilmemişse varsayılan durum DRAFT olur.
creationTime

string (Timestamp format)

Bu duyurunun oluşturulduğu 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 duyuruda 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 duyurunun yayınlanmasının planlandığı isteğe bağlı zaman damgası.

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)

Duyurunun atanan modu. Belirtilmediği takdirde varsayılan değer ALL_STUDENTS olur.
individualStudentsOptions

object (IndividualStudentsOptions)

Duyuruya erişimi olan öğrencilerin tanımlayıcıları. Bu alan yalnızca assigneeMode INDIVIDUAL_STUDENTS ise ayarlanır. assigneeMode simgesi INDIVIDUAL_STUDENTS ise duyuruyu yalnızca bu alanda belirtilen öğrenciler görebilir.
creatorUserId

string

Duyuruyu oluşturan kullanıcının tanımlayıcısı.

Salt okunur.

AnnouncementState

Duyuruların olası durumları

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

Yöntemler

create

 Duyuru oluşturur.

delete

 Duyuruları siler.

get

 Bir duyuruyu 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 duyuruların listesini döndürür.

modifyAssignees

 Bir duyurunun atananlar modunu ve seçeneklerini değiştirir.

patch

 Bir duyurunun bir veya daha fazla alanını günceller.