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)

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

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

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

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

छात्र-छात्राओं के सबमिशन की सूची बनाते समय जवाब.

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

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 उन StudentSubmissions को दिखाता है जिनमें देर से सबमिट करने की स्थिति 'गलत' के तौर पर सेट है.