Method: courses.topics.patch

Memperbarui satu atau beberapa kolom topik.

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika project developer yang meminta tidak membuat topik yang sesuai atau karena error akses.
  • INVALID_ARGUMENT jika permintaan memiliki format yang salah.
  • FAILED_PRECONDITION jika ada topik dalam kursus dengan nama yang sama.
  • NOT_FOUND jika kursus atau topik yang diminta tidak ada

Permintaan HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/topics/{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 topik.

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Mask yang mengidentifikasi kolom pada topik 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 Topik. Jika kolom yang tidak mendukung nilai kosong disertakan dalam mask pembaruan dan tidak ditetapkan di objek Topik, error INVALID_ARGUMENT akan ditampilkan.

Kolom berikut dapat ditentukan:

  • name

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

Isi permintaan

Isi permintaan memuat instance Topic.

Isi respons

Jika berhasil, isi respons memuat instance Topic.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.