Method: courses.courseWork.studentSubmissions.return

छात्र-छात्रा के सबमिट किए गए असाइनमेंट की जानकारी दिखाता है.

छात्र-छात्रा के सबमिट किए गए असाइनमेंट को वापस करने पर, Drive में अटैच की गई फ़ाइलों का मालिकाना हक छात्र-छात्रा को मिल जाता है. साथ ही, सबमिट किए गए असाइनमेंट का स्टेटस भी अपडेट हो सकता है. Classroom ऐप्लिकेशन के उलट, छात्र-छात्रा के सबमिट किए गए असाइनमेंट को वापस करने पर, assignedGrade की वैल्यू, draftGrade की वैल्यू पर सेट नहीं होती.

इस तरीके को सिर्फ़ उस कोर्स का शिक्षक कॉल कर सकता है जिसमें छात्र-छात्रा का सबमिट किया गया असाइनमेंट शामिल है.

यह अनुरोध, OAuth क्लाइंट आईडी के Developer Console प्रोजेक्ट से किया जाना चाहिए. इस आईडी का इस्तेमाल, संबंधित कोर्स वर्क आइटम या उससे जुड़े ऐड-ऑन अटैचमेंट को बनाने के लिए किया गया हो.

यह तरीका, गड़बड़ी के ये कोड दिखाता है:

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

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

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return

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

पाथ पैरामीटर

पैरामीटर
courseId

string

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

courseWorkId

string

कोर्स वर्क का आइडेंटिफ़ायर.

id

string

छात्र-छात्रा के सबमिट किए गए असाइनमेंट का आइडेंटिफ़ायर.

अनुरोध का मुख्य हिस्सा

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

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब का मुख्य हिस्सा एक खाली JSON ऑब्जेक्ट होता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/classroom.coursework.students

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