Method: courses.patch

Memperbarui satu atau beberapa kolom dalam kursus.

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika pengguna yang meminta tidak diizinkan untuk mengubah kursus yang diminta atau karena error akses.
  • NOT_FOUND jika tidak ada kursus dengan ID yang diminta.
  • INVALID_ARGUMENT jika kolom yang tidak valid ditentukan dalam mask pembaruan atau jika tidak ada mask pembaruan yang diberikan.
  • FAILED_PRECONDITION untuk error permintaan berikut:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
id

string

ID kursus yang akan diperbarui. ID ini dapat berupa ID yang ditetapkan Classroom atau alias.

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Mask yang mengidentifikasi kolom di kursus yang akan diperbarui. Kolom ini wajib diisi untuk melakukan pembaruan. Pembaruan akan gagal jika kolom yang ditentukan tidak valid. Kolom berikut valid:

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

Catatan: patch pada ownerId diperlakukan sebagai langsung efektif, tetapi dalam praktiknya mungkin perlu waktu beberapa saat hingga transfer kepemilikan semua resource yang terpengaruh selesai.

Jika ditetapkan dalam parameter kueri, kolom ini harus ditentukan sebagai

updateMask=<field1>,<field2>,...

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

Isi permintaan

Isi permintaan memuat instance Course.

Isi respons

Jika berhasil, isi respons memuat instance Course.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.