Method: courses.courseWorkMaterials.list

Talep eden kişinin görüntülemesine izin verilen kurs çalışması materyallerinin listesini döndürür.

Ders öğrencileri yalnızca PUBLISHED sınıf çalışması materyalini görüntüleyebilir. Ders öğretmenleri ve alan yöneticileri tüm sınıf çalışması materyallerini 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ı nedeniyle PERMISSION_DENIED.
  • İstek bozuksa INVALID_ARGUMENT.
  • İstenen ders 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 bir tanımlayıcı veya bir alias olabilir.

Sorgu parametreleri

Parametreler
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Çalışma durumuyla ilgili iade kısıtlaması. Yalnızca eşleşen sınıf çalışması materyalleri döndürülür. Belirtilmemesi durumunda, çalışma durumu PUBLISHED olan öğeler döndürülür.
orderBy

string

Sonuçlar için isteğe bağlı sıralama ölçütü. İsteğe bağlı bir sıralama yönü anahtar kelimesi içeren alanların virgülle ayrılmış 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

İade edilecek maksimum öğe sayısı. Sıfır veya belirtilmedi olarak, sunucunun maksimum değer atayabileceğini gösterir.

Sunucu, belirtilen sayıdan daha az sonuç döndürebilir.
pageToken

string

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

Aksi takdirde, list isteği, bu jetonu sağlayan istekle aynı olmalıdır.
materialDriveId

string

Kimliği sağlanan dizeyle eşleşen en az bir Drive materyaline sahip sınıf çalışması materyalleri için isteğe bağlı filtreleme. materialLink belirtilmişse ders ç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

Ders çalışma materyallerini listelerken yanıt verin.

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ı materyali öğeleri.
nextPageToken

string

Döndürülecek sonuçların sonraki sayfasını tanımlayan jeton. Boşsa başka sonuç sunulmaz.

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ılavuzunu inceleyin.