Method: courses.announcements.patch

Bir duyurunun 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 duyuruyu oluşturmamışsa veya erişim hataları nedeniyle.
  • INVALID_ARGUMENT ise istek yanlış biçimlendirilmiştir.
  • FAILED_PRECONDITION ise istenen duyuru zaten silinmiş demektir.
  • NOT_FOUND (İstenen kurs veya duyuru mevcut değilse)

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

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

string

Duyuru kimliği.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

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

Öğretmenler aşağıdaki alanları belirtebilir:

  • text
  • state
  • scheduledTime

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