Method: courses.courseWorkMaterials.list

İstekte bulunan kullanıcının görüntülemesine izin verilen kurs çalışması materyallerinin listesini döndürür.

Kurs öğrencileri yalnızca PUBLISHED kurs çalışması materyalini görüntüleyebilir. Ders öğretmenleri ve alan yöneticileri, tüm ders çalışma materyallerini görüntüleyebilir.

Bu yöntem aşağıdaki hata kodlarını döndürür:

  • PERMISSION_DENIED ise istek yapan kullanıcının istenen kursa erişmesine izin verilmemiştir veya erişim hataları vardır.
  • INVALID_ARGUMENT ise istek yanlış biçimlendirilmiştir.
  • NOT_FOUND ise istenen kurs mevcut değildir.

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

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

Sorgu parametreleri

Parametreler
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Döndürülecek çalışma durumunda kısıtlama. Yalnızca eşleşen sınıf çalışması materyalleri döndürülür. Belirtilmemesi durumunda, iş 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ış bir alan listesi. Desteklenen alan updateTime. Desteklenen yön anahtar kelimeleri asc ve desc'dir. Bir değer 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 belirtilmemiş, sunucunun maksimum bir 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. Sonuçların sonraki sayfasının döndürülmesi gerektiğini belirtir.

list isteği, bu jetonla sonuçlanan istekte belirtilenlerle aynı olmalıdır.
materialDriveId

string

Kimliği sağlanan dizeyle eşleşen en az bir Drive materyali içeren kurs çalışması materyali için isteğe bağlı filtreleme. materialLink de 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ışması materyalini listelerken 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 kurs çalışması materyali öğeleri.
nextPageToken

string

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

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 bakın.