REST Resource: courses.announcements

Resource: Pengumuman

Pengumuman 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 ditetapkan 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 memiliki lebih dari 20 item penting.

state

enum (AnnouncementState)

Status pengumuman ini. Jika tidak ditentukan, status defaultnya adalah DRAFT.

creationTime

string (Timestamp format)

Stempel waktu saat pengumuman ini dibuat.

Hanya baca.

Stempel waktu dalam 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 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 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 tugas pengumuman. Jika tidak ditentukan, nilai defaultnya adalah ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

ID siswa yang memiliki akses ke pengumuman. Kolom ini ditetapkan hanya jika assigneeMode adalah INDIVIDUAL_STUDENTS. Jika assigneeMode adalah INDIVIDUAL_STUDENTS, maka 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 ditentukan. Data ini tidak pernah ditampilkan.
PUBLISHED Status untuk pengumuman yang telah dipublikasikan. Ini adalah status default.
DRAFT Status untuk pengumuman yang belum dipublikasikan. Pengumuman di status ini hanya dapat dilihat oleh pengajar kursus dan administrator domain.
DELETED Status untuk pengumuman yang telah dipublikasikan, tetapi sekarang sudah dihapus. Pengumuman di 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 pemohon.

modifyAssignees

Mengubah mode penerima tugas dan opsi pengumuman.

patch

Memperbarui satu atau beberapa kolom pengumuman.