REST Resource: courses.announcements

Resource: 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 yang ditetapkan Classroom untuk pengumuman ini, 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 item materi.
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 ditetapkan 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 Status tidak ditentukan. Nilai 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 dipublikasikan, tetapi sekarang dihapus. Pengumuman dalam status ini hanya dapat dilihat oleh pengajar kursus dan administrator domain. Pengumuman dalam status ini akan dihapus setelah beberapa waktu.

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 oleh pemohon.

modifyAssignees

 Mengubah mode penerima dan opsi pengumuman.

patch

 Memperbarui satu atau beberapa kolom pengumuman.