Method: courses.announcements.patch

Duyurunun 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 projesi ilgili duyuruyu oluşturmadıysa veya erişim hataları varsa PERMISSION_DENIED.
  • İstek hatalıysa INVALID_ARGUMENT.
  • İstenen duyuru zaten silinmişse FAILED_PRECONDITION.
  • İstenen ders veya duyuru mevcut değilse NOT_FOUND

HTTP isteği

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{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

Duyurunun tanımlayıcısı.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Duyuruda 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 Duyuru nesnesinde değil, güncelleme maskesinde belirtilerek temizlenebilir. Güncelleme maskesine boş değerleri desteklemeyen bir alan eklenirse ve Duyuru nesnesinde ayarlanmazsa INVALID_ARGUMENT hatası döndürülür.

Aşağıdaki alanlar öğretmenler tarafından belirtilebilir:

  • text
  • state
  • scheduledTime

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

İstek içeriği

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

Yanıt gövdesi

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

Yetkilendirme kapsamları

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

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

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