Method: courses.courseWorkMaterials.list

İstek sahibinin görüntülemesine izin verilen sınıf çalışması materyallerinin listesini döndürür.

Ders öğrencileri yalnızca PUBLISHED sınıf çalışması materyallerini görebilir. Ders öğretmenleri ve alan yöneticileri tüm sınıf çalışması materyallerini görebilir.

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}/courseWorkMaterials

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.

Sorgu parametreleri

Parametreler
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

İade edilecek çalışma durumuyla ilgili kısıtlama. Yalnızca eşleşen sınıf çalışması materyalleri döndürülür. Belirtilmemişse çalışma durumu PUBLISHED olan öğeler döndürülür.
orderBy

string

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. updateTime alanı desteklenir. Desteklenen yol tarifi anahtar kelimeleri: asc ve desc. Belirtilmezse varsayılan davranış updateTime desc olur. Örnekler: updateTime asc, updateTime
pageSize

integer

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

string

nextPageToken değeri, sonraki sonuç sayfasının döndürülmesi gerektiğini belirten önceki bir list çağrısından döndürüldü.

list isteği, aksi takdirde bu jetonla sonuçlanan istekle aynı olmalıdır.
materialDriveId

string

Kimliği sağlanan dizeyle eşleşen en az bir Drive materyali içeren sınıf çalışması materyalleri için isteğe bağlı filtreleme. materialLink belirtilmişse sınıf çalışması materyalinde her iki filtreyle de eşleşen materyaller bulunmalıdır.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Sınıf çalışması materyalleri listelenirken verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "courseWorkMaterial": [
    {
      object (CourseWorkMaterial)
    }
  ],
  "nextPageToken": string
}
Alanlar
courseWorkMaterial[]

object (CourseWorkMaterial)

İstekle eşleşen sınıf çalışması materyal öğeleri.
nextPageToken

string

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.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

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