Method: courses.announcements.patch

Memperbarui satu atau beberapa kolom pengumuman.

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika project developer yang meminta tidak membuat pengumuman yang sesuai atau karena error akses.
  • INVALID_ARGUMENT jika permintaan memiliki format yang salah.
  • FAILED_PRECONDITION jika pengumuman yang diminta telah dihapus.
  • NOT_FOUND jika kursus atau pengumuman yang diminta tidak ada

Permintaan HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{id}

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
courseId

string

ID kursus. ID ini dapat berupa ID yang ditetapkan Classroom atau alias.
id

string

ID pengumuman.

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Mask yang mengidentifikasi kolom mana di pengumuman yang akan diperbarui. Kolom ini wajib diisi untuk melakukan pembaruan. Pembaruan akan gagal jika kolom yang ditentukan tidak valid. Jika mendukung nilai kosong, kolom dapat dihapus dengan menentukannya di mask pembaruan, bukan di objek Pengumuman. Jika kolom yang tidak mendukung nilai kosong disertakan dalam mask pembaruan dan tidak ditetapkan di objek Pengumuman, error INVALID_ARGUMENT akan ditampilkan.

Kolom berikut dapat ditentukan oleh pengajar:

  • text
  • state
  • scheduledTime

Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

Isi permintaan

Isi permintaan memuat instance Announcement.

Isi respons

Jika berhasil, isi respons memuat instance Announcement.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/classroom.announcements

Untuk informasi selengkapnya, lihat Panduan otorisasi.