- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Deneyin.
İstekte bulunan kişinin görüntülemesine izin verilen duyuruların listesini döndürür.
Kurs öğrencileri yalnızca PUBLISHED
duyurularını görüntüleyebilir. Kurs öğretmenleri ve alan yöneticileri tüm duyuruları görüntüleyebilir.
Bu yöntem aşağıdaki hata kodlarını döndürür:
- İstekte bulunan kullanıcının, istenen derse erişmesine izin verilmiyorsa veya erişim hataları varsa
PERMISSION_DENIED
. - İstek hatalıysa
INVALID_ARGUMENT
. - İstenen kurs mevcut değilse
NOT_FOUND
.
HTTP isteği
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
courseId |
Kursun tanımlayıcısı. Bu tanımlayıcı, Classroom tarafından atanan tanımlayıcı veya bir |
Sorgu parametreleri
Parametreler | |
---|---|
announcementStates[] |
Duyuruların |
orderBy |
Sonuçlar için isteğe bağlı sıralama düzeni. İsteğe bağlı bir sıralama yönü anahtar kelimesi içeren virgülle ayrılmış alan listesi. |
pageSize |
Döndürülecek maksimum öğe sayısı. Sıfır veya belirtilmedi, sunucunun bir maksimum değer atayabileceğini gösterir. Sunucu, belirtilen sayıdan daha az sonuç döndürebilir. |
pageToken |
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Ders çalışması listelenirken verilen yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"announcements": [
{
object ( |
Alanlar | |
---|---|
announcements[] |
İstekle eşleşen duyuru öğeleri. |
nextPageToken |
Döndürülecek bir sonraki sonuç sayfasını tanımlayan jeton. Boş bırakılırsa başka sonuç yok. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/classroom.announcements
https://www.googleapis.com/auth/classroom.announcements.readonly
Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.