REST Resource: courses.announcements

Kaynak: Duyuru

Bir öğretmen tarafından kurstaki öğrenciler 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

Dersin tanımlayıcısıdır.

Salt okunur.
id

string

Bu duyurunun Classroom tarafından atanan ve kurs başına benzersiz olan tanımlayıcısı.

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 materyal öğesi bulunmalıdır.
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 çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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 çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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 çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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 atanmış kullanıcı 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 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ıdır.

Salt okunur.

AnnouncementState

Duyuruların olası durumları

Sıralamalar
ANNOUNCEMENT_STATE_UNSPECIFIED Eyalet belirtilmedi. Bu bilgiler hiçbir zaman geri gönderilmez.
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 artık 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

 Bir duyuruyu siler.

get

 Bir duyuru döndürür.

getAddOnContext

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

list

 İsteği gönderen kullanıcının görüntülemesine izin verilen duyuruların listesini döndürür.

modifyAssignees

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

patch

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