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

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

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 देर से सबमिट किए गए असाइनमेंट के लिए, StudentSubmissions फ़ील्ड की वैल्यू दिखाएं.
NOT_LATE_ONLY देर से सबमिट किए गए छात्र-छात्राओं के काम की जानकारी दिखाने के लिए, late फ़ील्ड को गलत के तौर पर सेट करें.