Method: courses.courseWork.studentSubmissions.list

İsteğin OAuth kapsamları dikkate alınarak, istekte bulunan kişinin görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür. -, öğrenci gönderimlerini birden fazla sınıf çalışması öğesi için 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: İstekte bulunan kullanıcının, istenen derse veya sınıf çalışmasına erişmesine izin verilmiyorsa veya erişim hataları varsa.
  • İstek hatalıysa INVALID_ARGUMENT.
  • İstenen kurs 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 tanımlayıcı veya bir alias olabilir.
courseWorkId

string

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

Sorgu parametreleri

Parametreler
userId

string

Geri verilen öğrenci çalışmalarını, belirtilen tanımlayıcıya sahip öğrencinin sahip olduğu ödevlerle kısıtlamak için kullanılan 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ı gösteren "me" dize değeri
states[]

enum (SubmissionState)

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

enum (LateValues)

İstenen gecikme değeri. Belirtilirse geri verilen öğrenci gönderimleri istenen değerle kısıtlanır. Bu değer belirtilmezse gönderimler late değerinden bağımsız olarak döndürülür.
pageSize

integer

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

string

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

list isteği, aksi takdirde bu jetonla sonuçlanan 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önderimleri listelenirken verilen yanıt.

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 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.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ılavuzuna göz atın.

LateValues

İade edilen öğelerin geç değeriyle ilgili kısıtlamalar.

Sıralamalar
LATE_VALUES_UNSPECIFIED Gönderim geç değerleriyle ilgili bir kısıtlama belirtilmedi.
LATE_ONLY Öğrenci gönderimlerini geç teslim edin.
NOT_LATE_ONLY StudentSubmissions'ı Gecikme değeri yanlış olacak şekilde iade edin.