Method: courses.courseWork.studentSubmissions.list

छात्र-छात्राओं के ऐसे असाइनमेंट की सूची दिखाता है जिन्हें देखने की अनुमति है. यह सूची, अनुरोध के OAuth दायरों में शामिल की जाती है. - को courseWorkId के तौर पर दिखाया जा सकता है, ताकि कई कोर्स वर्क आइटम के लिए छात्र-छात्राओं के सबमिशन शामिल किए जा सकें.

कोर्स के छात्र-छात्राएं सिर्फ़ अपना काम देख सकते हैं. कोर्स के शिक्षक और डोमेन एडमिन, सभी छात्र-छात्राओं के असाइनमेंट देख सकते हैं.

इस तरीके से गड़बड़ी के ये कोड दिखते हैं:

  • PERMISSION_DENIED अगर अनुरोध करने वाले उपयोगकर्ता को, अनुरोध किए गए कोर्स या कोर्स वर्क या ऐक्सेस से जुड़ी गड़बड़ियों को ऐक्सेस करने की अनुमति नहीं है.
  • अगर अनुरोध में गड़बड़ी है, तो INVALID_ARGUMENT.
  • अगर अनुरोध किया गया कोर्स मौजूद नहीं है, तो NOT_FOUND.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
courseId

string

कोर्स का आइडेंटिफ़ायर. यह आइडेंटिफ़ायर, Classroom से असाइन किया गया कोई आइडेंटिफ़ायर या alias हो सकता है.
courseWorkId

string

छात्र/छात्रा के अनुरोध किए जाने वाले काम का आइडेंटिफ़ायर. इसे लिटरल "-" स्ट्रिंग पर सेट किया जा सकता है, ताकि बताए गए कोर्स के सभी कोर्स वर्क के लिए, छात्र/छात्रा के असाइनमेंट का अनुरोध किया जा सके.

क्वेरी पैरामीटर

पैरामीटर
userId

string

छात्र-छात्राओं के काम को, बताए गए आइडेंटिफ़ायर वाले मालिकाना हक वाले कॉन्टेंट पर सीमित करने के लिए, वैकल्पिक तर्क. आइडेंटिफ़ायर इनमें से कोई एक हो सकता है:

  • उपयोगकर्ता के लिए न्यूमेरिक आइडेंटिफ़ायर
  • उपयोगकर्ता का ईमेल पता
  • स्ट्रिंग लिटरल "me", जो अनुरोध करने वाले उपयोगकर्ता को दिखाता है
states[]

enum (SubmissionState)

अनुरोध किए गए सबमिशन की स्थिति. अगर बताया गया है, तो लौटाए गए छात्र-छात्राओं के असाइनमेंट, सबमिट की गई किसी एक स्थिति से मेल खाते हैं.
late

enum (LateValues)

देरी का अनुरोध किया गया मान. अगर बताया गया है, तो लौटाए गए छात्र-छात्राओं के असाइनमेंट, अनुरोध की गई वैल्यू के हिसाब से प्रतिबंधित होंगे. अगर जानकारी नहीं है, तो late वैल्यू की परवाह किए बिना सबमिशन लौटाए जाते हैं.
pageSize

integer

लौटाने के लिए आइटम की ज़्यादा से ज़्यादा संख्या. शून्य या जानकारी नहीं होने का मतलब है कि सर्वर ज़्यादा से ज़्यादा वैल्यू असाइन कर सकता है.

सर्वर, तय की गई संख्या से कम नतीजे दिखा सकता है.
pageToken

string

पिछले list कॉल से मिली nextPageToken वैल्यू. इससे पता चलता है कि नतीजों का अगला पेज दिखाया जाना चाहिए.

list अनुरोध, इस टोकन में मिले अनुरोध के जैसा होना चाहिए.
previewVersion

enum (PreviewVersion)

ज़रूरी नहीं. एपीआई का झलक वाला वर्शन. 'झलक देखें' कार्यक्रम में डेवलपर को उपलब्ध कराई गई एपीआई की नई सुविधाओं को ऐक्सेस करने के लिए, इसे सेट करना ज़रूरी है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

छात्र/छात्रा के असाइनमेंट सबमिट करते समय जवाब दें.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
studentSubmissions[]

object (StudentSubmission)

छात्र-छात्रा का काम, जो अनुरोध के मुताबिक किया गया हो.
nextPageToken

string

टोकन, जो दिखाए जाने वाले नतीजों के अगले पेज की पहचान करता है. अगर यह फ़ील्ड खाली है, तो कोई और नतीजा नहीं मिलेगा.

अनुमति के दायरे

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • 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

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.

LateValues

लौटाए गए आइटम की देर से वैल्यू देने पर पाबंदियां.

Enums
LATE_VALUES_UNSPECIFIED देरी से सबमिट की गई वैल्यू पर कोई पाबंदी नहीं है.
LATE_ONLY उन छात्र-छात्राओं के लिए सबमिट किए गए अनुरोध सबमिट करें जहां देरी से जवाब सही हो.
NOT_LATE_ONLY जिन छात्र-छात्राओं को जवाब में दी गई जानकारी गलत है उनके लिए 'छात्र-छात्राओं के लिए सबमिट किए गए संसाधन' दिखाएं.