Method: courses.topics.patch

Bir konunun bir veya daha fazla alanını günceller.

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

  • İstekte bulunan geliştirici projesinin ilgili konuyu oluşturmaması veya erişim hataları olması durumunda PERMISSION_DENIED.
  • İstek hatalıysa INVALID_ARGUMENT.
  • İstenen ders veya konu mevcut değilse NOT_FOUND

HTTP isteği

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

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

Yol parametreleri

Parametreler
courseId

string

Kursun tanımlayıcısı. Bu tanımlayıcı, Classroom tarafından atanan tanımlayıcı veya bir alias olabilir.
id

string

Konunun tanımlayıcısı.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Konuda hangi alanların güncelleneceğini tanımlayan maske. Bu alan güncelleme için gereklidir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Bir alan boş değerleri destekliyorsa bu alan, Konu nesnesinde değil, güncelleme maskesinde belirtilerek temizlenebilir. Güncelleme maskesine boş değerleri desteklemeyen bir alan eklenirse ve Konu nesnesinde ayarlanmazsa INVALID_ARGUMENT hatası döndürülür.

Aşağıdaki alanlar belirtilebilir:

  • name

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

İstek içeriği

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

Yanıt gövdesi

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

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.