REST Resource: courses.announcements

Referensi: Pengumuman

Pengumuman yang dibuat oleh pengajar untuk siswa kursus

Representasi JSON 
{
  "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
}
Kolom
courseId

string

ID kursus.

Hanya baca.
id

string

ID pengumuman ini yang diberikan Classroom, unik per kursus.

Hanya baca.
text

string

Deskripsi pengumuman ini. Teks harus berupa string UTF-8 yang valid dan berisi tidak lebih dari 30.000 karakter.
materials[]

object (Material)

Materi tambahan.

Pengumuman tidak boleh berisi lebih dari 20 hal yang penting.
state

enum (AnnouncementState)

Status pengumuman ini. Jika tidak ditentukan, status default-nya adalah DRAFT.
creationTime

string (Timestamp format)

Stempel waktu saat pengumuman ini dibuat.

Hanya baca.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Stempel waktu perubahan terbaru pada pengumuman ini.

Hanya baca.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
scheduledTime

string (Timestamp format)

Stempel waktu opsional saat pengumuman ini dijadwalkan untuk dipublikasikan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
assigneeMode

enum (AssigneeMode)

Mode penerima pengumuman. Jika tidak ditentukan, nilai defaultnya adalah ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

ID siswa yang memiliki akses ke pengumuman. Kolom ini hanya disetel jika assigneeMode adalah INDIVIDUAL_STUDENTS. Jika assigneeMode adalah INDIVIDUAL_STUDENTS, hanya siswa yang ditentukan di kolom ini yang dapat melihat pengumuman.
creatorUserId

string

ID untuk pengguna yang membuat pengumuman.

Hanya baca.

AnnouncementState

Kemungkinan status pengumuman

Enum
ANNOUNCEMENT_STATE_UNSPECIFIED Tidak ada negara bagian yang ditetapkan. Ini tidak pernah ditampilkan.
PUBLISHED Status untuk pengumuman yang telah dipublikasikan. Ini adalah status default.
DRAFT Status untuk pengumuman yang belum dipublikasikan. Pengumuman dalam status ini hanya dapat dilihat oleh pengajar kursus dan administrator domain.
DELETED Status untuk pengumuman yang telah dipublikasikan, tetapi sekarang dihapus. Pengumuman dalam status ini hanya dapat dilihat oleh pengajar kursus dan administrator domain. Pengumuman dalam status ini dihapus setelah beberapa saat.

Metode

create

 Membuat pengumuman.

delete

 Menghapus pengumuman.

get

 Menampilkan pengumuman.

getAddOnContext

 Mendapatkan metadata untuk add-on Classroom dalam konteks postingan tertentu.

list

 Menampilkan daftar pengumuman yang diizinkan untuk dilihat pemohon.

modifyAssignees

 Memodifikasi mode penerima tugas dan opsi pengumuman.

patch

 Memperbarui satu atau beberapa kolom pengumuman.