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 kurs çalışması öğesi için öğrenci gönderimlerini içerecek şekilde courseWorkId olarak belirtilebilir.

Kurs öğ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 ise istek yapan kullanıcının istenen derse veya ders çalışmasına erişmesine izin verilmez veya erişim hataları yaşanır.
  • INVALID_ARGUMENT ise istek yanlış biçimlendirilmiştir.
  • NOT_FOUND ise istenen kurs mevcut değildir.

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

Dersin tanımlayıcısıdır. 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ıdır. Belirtilen kurstaki tüm kurs çalışmaları için öğrenci çalışması isteğinde bulunmak üzere bu parametre "-" dize değişmezi olarak 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
  • İstekte bulunan kullanıcıyı belirten "me" değişmez dizesi
states[]

enum (SubmissionState)

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

enum (LateValues)

İstenen geç kalma değeri. Belirtilen değer, geri verilen öğrenci gönderimlerini kısıtlar. 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ş, sunucunun maksimum bir 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. Sonuçların sonraki sayfasının döndürülmesi gerektiğini belirtir.

list isteği, bu jetonla sonuçlanan istekte belirtilenlerle aynı 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 yapılmalıdır.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Öğrenci gönderimlerini listelediğinizde gösterilen 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şsa başka sonuç yoktur.

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

LateValues

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

Sıralamalar
LATE_VALUES_UNSPECIFIED Gönderimde geç değerlerle ilgili herhangi bir kısıtlama belirtilmedi.
LATE_ONLY late değerinin doğru olduğu StudentSubmissions öğelerini döndürme.
NOT_LATE_ONLY late değerinin yanlış olduğu StudentSubmissions öğelerini döndürme.