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 untuk 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 kesalahan permintaan berikut:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner
    • CourseTitleCannotContainUrl

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 tidak valid ditentukan. Kolom berikut valid:

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

Catatan: patch ke ownerId dianggap langsung berlaku, 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 comma-separated list berisi 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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.