Method: courses.courseWork.studentSubmissions.list

İsteğin OAuth kapsamları da hesaba katılarak, istekte bulunan kişinin görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür. -, öğrencilerin birden çok sınıf çalışması öğesi için gönderimlerini dahil etmek üzere courseWorkId olarak belirtilebilir.

Ders öğrencileri yalnızca kendi çalışmalarını görüntüleyebilir. Ders öğretmenleri ve alan yöneticileri tüm öğrenci gönderimlerini görüntüleyebilir.

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

  • PERMISSION_DENIED istekte bulunan kullanıcının istenen kursa veya kurs çalışmasına ya da erişim hataları erişmesine izin verilmiyorsa.
  • İstek bozuksa INVALID_ARGUMENT.
  • İstenen ders mevcut değilse NOT_FOUND.

HTTP isteği

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions

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.
courseWorkId

string

İstenecek öğrenci çalışmasının tanımlayıcısı. Bu, belirtilen dersteki tüm sınıf çalışmaları için öğrenci çalışmalarını talep etmek üzere "-" dizesine ayarlanabilir.

Sorgu parametreleri

Parametreler
userId

string

Geri verilen öğrenci çalışmalarını, belirtilen tanımlayıcıya sahip öğrencinin sahip olduğu çalışmalarla kısıtlamak için isteğe bağlı bağımsız değişken. Tanımlayıcı aşağıdakilerden biri olabilir:

  • kullanıcının sayısal tanımlayıcısı
  • kullanıcının e-posta adresi
  • istekte bulunan kullanıcıyı belirten dize değişmez değeri ("me")
states[]

enum (SubmissionState)

İstenen gönderim durumları. Belirtilmesi durumunda, geri verilen öğrenci gönderimleri belirtilen gönderim durumlarından biriyle eşleşir.
late

enum (LateValues)

İstenen gecikme değeri. Belirtilirse geri verilen öğrencilerin gönderimleri, istenen değerle kısıtlanır. Belirtilmemesi durumunda, gönderimler late değerinden bağımsız olarak döndürülür.
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.
previewVersion

enum (PreviewVersion)

İsteğe bağlı. API'nin önizleme sürümü. Bu, Önizleme Programı'nda geliştiricilere sunulan yeni API özelliklerine erişmek için ayarlanmalıdır.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Öğrenci gönderimlerini listelerken yanıt verin.

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

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

object (StudentSubmission)

İstekle eşleşen öğrenci çalışmaları.
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.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.

LateValues

İade edilen ürünlerin geç değeriyle ilgili kısıtlamalar.

Sıralamalar
LATE_VALUES_UNSPECIFIED Gönderim gecikmiş değerleriyle ilgili herhangi bir kısıtlama belirtilmedi.
LATE_ONLY Gecikmeli geçerli olduğu durumlarda Öğrenci Gönderimlerini geri verin.
NOT_LATE_ONLY Geciken yanlış seçeneği için Öğrenci Gönderimlerini geri ver.