REST Resource: courses.announcements

Kaynak: Duyuru

Bir öğretmen tarafından dersin öğ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 duyurunun Classroom tarafından atanan tanımlayıcısıdır (her ders için benzersizdir).

Salt okunur.

text

string

Bu duyurunun açıklaması. Metin,en fazla 30.000 karakter içeren geçerli bir UTF-8 dizesi olmalıdır.

materials[]

object (Material)

Ek materyaller.

Duyurularda en fazla 20 önemli öğe bulunabilir.

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.

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 duyuruda 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".

scheduledTime

string (Timestamp format)

Bu duyurunun 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".

assigneeMode

enum (AssigneeMode)

Duyurunun atanan modu. Bir değer belirtilmediyse 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 değeri INDIVIDUAL_STUDENTS ise duyuruyu yalnızca bu alanda belirtilen öğrenciler görebilir.

creatorUserId

string

Duyuruyu oluşturan kullanıcının kimliği.

Salt okunur.

AnnouncementState

Olası duyuru durumları

Sıralamalar
ANNOUNCEMENT_STATE_UNSPECIFIED Eyalet belirtilmedi. Bu bilgi 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 ders öğretmenleri ve alan yöneticileri tarafından görülebilir.
DELETED Yayınlanan ancak silinmiş olan duyurunun durumu. Bu durumdaki duyurular yalnızca ders öğretmenleri ve alan yöneticileri tarafından görülebilir. Bu durumdaki duyuru bir süre sonra silinir.

Yöntemler

create

Duyuru oluşturur.

delete

Duyuruyu siler.

get

Bir duyuru döndürür.

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

modifyAssignees

Atanan modu ve duyuru seçeneklerini değiştirir.

patch

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