- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- LateValues
- Deneyin.
İ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 |
Kursun tanımlayıcısı. Bu tanımlayıcı, Classroom tarafından atanan tanımlayıcı veya bir |
courseWorkId |
İ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 |
Sorgu parametreleri
Parametreler | |
---|---|
userId |
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:
|
states[] |
İstenen gönderim durumları. Belirtilmişse, geri verilen öğrenci gönderimleri belirtilen gönderim durumlarından biriyle eşleşir. |
late |
İstenen gecikme değeri. Belirtilirse geri verilen öğrenci gönderimleri istenen değerle kısıtlanır. Bu değer belirtilmezse gönderimler |
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 |
|
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 ( |
Alanlar | |
---|---|
studentSubmissions[] |
İstekle eşleşen öğrenci çalışmaları. |
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.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. |