Method: courses.patch

Bir kurstaki bir veya daha fazla alanı günceller.

Bu yöntem aşağıdaki hata kodlarını döndürür:

  • İstekte bulunan kullanıcının istenen kursu değiştirmesine izin verilmiyorsa veya erişim hataları için PERMISSION_DENIED.
  • İstenen kimliğe sahip bir kurs yoksa NOT_FOUND.
  • Güncelleme maskesinde geçersiz alanlar belirtilmişse veya güncelleme maskesi sağlanmamışsa INVALID_ARGUMENT
  • Aşağıdaki istek hataları için FAILED_PRECONDITION:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner
    • CourseTitleCannotContainUrl

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
id

string

Güncellenecek kursun tanımlayıcısı. Bu tanımlayıcı, Classroom tarafından atanan tanımlayıcı veya bir alias olabilir.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Kurstaki hangi alanların güncelleneceğini belirleyen maske. Güncelleme yapmak için bu alanın doldurulması zorunludur. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Aşağıdaki alanlar geçerlidir:

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

Not: ownerId'ye yönelik yamalar hemen geçerli olacak şekilde değerlendirilir ancak etkilenen tüm kaynakların sahiplik aktarımının tamamlanması biraz zaman alabilir.

Bir sorgu parametresinde ayarlandığında bu alan şu şekilde belirtilmelidir:

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

Bu, alanların tam nitelikli adlarının virgülle ayrılmış listesidir. Örnek: "user.displayName,photo".

İstek içeriği

İstek metni, Course öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılıysa yanıt metni, Course öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.