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 terkait atau karena error akses.
  • INVALID_ARGUMENT jika permintaan salah format.
  • 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 diberikan Classroom atau alias.

id

string

ID pengumuman.

Parameter kueri

Parameter
updateMask

string (FieldMask format)

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

Kolom berikut dapat ditetapkan oleh pengajar:

  • text
  • state
  • scheduledTime

Ini adalah daftar yang 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 akan berisi instance Announcement.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.