- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Deneyin.
İ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 |
Kursun tanımlayıcısı. Bu tanımlayıcı, Classroom tarafından atanan tanımlayıcı veya bir |
Sorgu parametreleri
Parametreler | |
---|---|
courseWorkMaterialStates[] |
İ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 |
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 |
|
materialLink |
URL'si sağlanan dizeyle kısmen eşleşen en az bir bağlantı materyalinin yer aldığı sınıf çalışması materyalleri için isteğe bağlı filtreleme. |
materialDriveId |
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. |
İ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 ( |
Alanlar | |
---|---|
courseWorkMaterial[] |
İstekle eşleşen sınıf çalışması materyal öğ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.courseworkmaterials
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.