Method: courses.courseWorkMaterials.list

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

Derse kayıtlı öğrenciler yalnızca PUBLISHED ders materyallerini görüntüleyebilir. Ders öğretmenleri ve alan yöneticileri tüm ders 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 kursa erişmesine izin verilmiyorsa veya erişim hataları için PERMISSION_DENIED
  • İstek yanlış biçimlendirilmişse 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)

Döndürülecek çalışma durumuyla ilgili kısıtlama. Yalnızca eşleşen sınıf çalışması materyalleri döndürülür. Belirtilmemesi halinde, PUBLISHED iş durumuna sahip öğ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. Desteklenen alan updateTime. Desteklenen yön anahtar kelimeleri asc ve desc'dir. 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ş değer, sunucunun maksimum değer atayabileceğini gösterir.

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

string

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

list isteği, bu jetonla sonuçlanan istekle başka bir açıdan 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 da belirtilmişse kurs çalışması materyali, her iki filtreyle eşleşen materyallere sahip olmalıdır.
previewVersion

enum (PreviewVersion)

İsteğe bağlı. API'nin önizleme sürümü. Önizleme Programı'nda geliştiricilere sunulan yeni API özelliklerine erişmek için bu ayarın yapılması gerekir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Ders materyali 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)

İsteğe uygun kurs materyali öğeleri.
nextPageToken

string

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

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