Method: courses.courseWork.studentSubmissions.list

İstekte bulunan kullanıcının görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür. Bu işlemde isteğin OAuth kapsamları dikkate alınır. Birden fazla ders çalışması öğesi için öğrenci gönderimlerini dahil etmek üzere courseWorkId olarak tire (-) belirtilebilir.

Kurs öğrencileri yalnızca kendi çalışmalarını görüntüleyebilir. Kurs öğ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:

  • İstekte bulunan kullanıcının istenen kursa veya kurs çalışmasına erişmesine izin verilmiyorsa ya da 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}/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

İstenen öğrenci çalışmasının tanımlayıcısı. Belirtilen kurstaki tüm kurs çalışmaları için öğrenci çalışması istemek üzere bu, "-" dize değişmezine ayarlanabilir.

Sorgu parametreleri

Parametreler
userId

string

Döndürülen öğrenci çalışmalarını, belirtilen tanımlayıcıya sahip öğrenciye ait olanlarla sınırlamak 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
  • İstekte bulunan kullanıcıyı belirten "me" değişmez dizesi
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. Belirtilmişse geri verilen öğrenci gönderimleri, istenen değerle sınırlandırılır. Belirtilmemesi halinde, 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 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 açılardan aynı olmalıdır.
previewVersion

enum (PreviewVersion)

İsteğe bağlı. API'nin önizleme sürümü. Önizleme Programı'nda geliştiricilerin kullanımına sunulan yeni API özelliklerine erişmek için bu ayar yapılmalıdır.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Öğ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ışması.
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.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ılavuzu'na bakın.

LateValues

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

Sıralamalar
LATE_VALUES_UNSPECIFIED Geç gönderim değerleriyle ilgili herhangi bir kısıtlama belirtilmedi.
LATE_ONLY Geç teslim edilen StudentSubmissions'ları döndürür.
NOT_LATE_ONLY Geç teslim edilmemiş StudentSubmission'ları döndürür.