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:

  • PERMISSION_DENIED ise istek gönderen geliştirici projesi ilgili konuyu oluşturmamışsa veya erişim hataları varsa.
  • INVALID_ARGUMENT ise istek yanlış biçimlendirilmiştir.
  • İstenen kurs 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

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

string

Konunun tanımlayıcısıdır.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Konudaki hangi alanların güncelleneceğini tanımlayan maske. Güncelleme yapmak için bu alanın doldurulması gerekir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Boş değerleri destekleyen bir alan, Topic nesnesinde değil güncelleme maskesinde belirtilerek temizlenebilir. Boş değerleri desteklemeyen bir alan güncelleme maskesine dahil edilirse ve Konu nesnesinde ayarlanmazsa INVALID_ARGUMENT hatası döndürülür.

Aşağıdaki alanlar belirtilebilir:

  • name

Bu, alanların tam nitelikli 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 bakın.