REST Resource: courses.announcements

Kaynak: Duyuru

Dersin öğrencileri için öğretmen tarafından 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ı (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 olmalıdır.
state

enum (AnnouncementState)

Bu duyurunun durumu. Bir değer belirtilmezse varsayılan durum DRAFT olur.
creationTime

string (Timestamp format)

Bu duyurunun oluşturulduğu zaman damgası.

Salt okunur.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
scheduledTime

string (Timestamp format)

Bu duyurunun yayınlanmak üzere planlandığı isteğe bağlı zaman damgası.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
assigneeMode

enum (AssigneeMode)

Duyurunun atanan modu. Bir değer belirtilmezse varsayılan değer ALL_STUDENTS olur.
individualStudentsOptions

object (IndividualStudentsOptions)

Duyuruya erişimi olan öğrencilerin tanımlayıcıları. Bu alan yalnızca assigneeMode değeri 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 tanımlayıcısı.

Salt okunur.

AnnouncementState

Duyuruların olası durumları

Sıralamalar
ANNOUNCEMENT_STATE_UNSPECIFIED Eyalet belirtilmedi. Bu değer asla döndürülmez.
PUBLISHED Yayınlanan duyurunun durumu. Bu, varsayılan durumdur.
DRAFT Henüz yayınlanmamış bir duyurunun durumu. Bu durumdaki duyuru yalnızca ders öğretmenleri ve alan yöneticileri tarafından görülebilir.
DELETED Yayınlanan ancak silinen duyurunun durumu. Bu durumdaki duyuru 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

 Duyuruları siler.

get

 Bir duyuru döndürür.

getAddOnContext

 Belirli bir yayın bağlamında Classroom eklentileri için meta verileri alır.

list

 İstekte bulunan kişinin görüntülemesine izin verilen duyuruların listesini döndürür.

modifyAssignees

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

patch

 Duyurunun bir veya daha fazla alanını günceller.