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)

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

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

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

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

छात्र/छात्रा के सबमिशन की लिस्टिंग करते समय जवाब देना.

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

जेएसओएन के काेड में दिखाना 
{
  "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 जहां देरी गलत हो वहां 'छात्र-छात्राओं के लिए सबमिशन' दिखाएं.