Classroom ऐप्लिकेशन में तीन तरह के स्ट्रीम आइटम इस्तेमाल किए जा सकते हैं:
CourseWork, CourseWorkMaterials, और Announcements. इस गाइड में, CourseWork को मैनेज करने का तरीका बताया गया है. हालांकि, सभी स्ट्रीम आइटम के लिए एपीआई एक जैसे होते हैं. स्ट्रीम आइटम के टाइप और उनके अंतर के बारे में ज़्यादा जानने के लिए, एपीआई संसाधन देखें.
CourseWork संसाधन, किसी कोर्स में छात्रों को असाइन किए गए वर्क आइटम को दिखाता है. इसमें अन्य संसाधन और जानकारी भी शामिल होती है. जैसे, सबमिट करने की आखिरी तारीख या ज़्यादा से ज़्यादा स्कोर. CourseWork के चार सबटाइप होते हैं:
असाइनमेंट, क्विज़ असाइनमेंट, छोटे जवाब वाले सवाल, और
कई विकल्प वाले सवाल. Classroom API, इन तीन सबटाइप के साथ काम करता है: असाइनमेंट, छोटे जवाब वाले सवाल, और जवाबों के कई विकल्पों वाले सवाल. इन टाइप को CourseWork.workType फ़ील्ड से दिखाया जाता है.
CourseWork संसाधन के अलावा, StudentSubmission संसाधन का इस्तेमाल करके भी, पूरे हो चुके काम को मैनेज किया जा सकता है.
Create CourseWork
CourseWork को कोर्स के शिक्षक की ओर से सिर्फ़ बनाया जा सकता है.
किसी छात्र-छात्रा या ऐसे डोमेन एडमिन की ओर से CourseWork बनाने की कोशिश करने पर CourseWork गड़बड़ी होती है जो कोर्स में शिक्षक नहीं है.PERMISSION_DENIED Classroom में अलग-अलग भूमिकाओं के बारे में ज़्यादा जानने के लिए, उपयोगकर्ता के टाइप देखें.
courses.courseWork.create तरीके का इस्तेमाल करके CourseWork बनाते समय, लिंक को materials के तौर पर अटैच किया जा सकता है. इसे यहां दिए गए सैंपल कोड में दिखाया गया है:
Java
Python
title और workType फ़ील्ड ज़रूरी हैं. अन्य सभी फ़ील्ड में जानकारी देना ज़रूरी नहीं है.
अगर state की वैल्यू नहीं दी गई है, तो CourseWork को ड्राफ़्ट के तौर पर बनाया जाता है.
CourseWork में लिंक किए गए कॉन्टेंट को शामिल करने के लिए, टारगेट url के साथ लिंक किए गए संसाधन का इस्तेमाल करें. Classroom, title और थंबनेल इमेज का यूआरएल (thumbnailUrl) अपने-आप फ़ेच करता है. Classroom API, Google Drive और YouTube के कॉन्टेंट के साथ भी काम करता है. इन्हें DriveFile संसाधन या YouTubeVideo संसाधन के साथ शामिल किया जा सकता है.
सबमिट करने की तारीख तय करने के लिए, dueDate और dueTime फ़ील्ड को यूटीसी के हिसाब से सेट करें. अनुमति के अनुरोध पूरे होने की तारीख, आने वाले समय की होनी चाहिए.
CourseWork रिस्पॉन्स में, सर्वर की ओर से असाइन किया गया एक आइडेंटिफ़ायर शामिल होता है. इसका इस्तेमाल, अन्य एपीआई अनुरोधों में असाइनमेंट का रेफ़रंस देने के लिए किया जा सकता है.
CourseWork वापस पाएं
आपके पास, उस कोर्स में शामिल छात्र-छात्राओं और शिक्षकों की ओर से CourseWork को वापस पाने का विकल्प होता है. आपके पास डोमेन एडमिन की ओर से भी CourseWork को वापस पाने का विकल्प होता है. भले ही, वे कोर्स में शिक्षक न हों. किसी CourseWork को वापस लाने के लिए, courses.courseWork.get का इस्तेमाल करें. सभी CourseWork (ज़रूरत पड़ने पर कुछ शर्तों के साथ) को वापस पाने के लिए, courses.courseWork.list का इस्तेमाल करें.
ज़रूरी स्कोप, इस बात पर निर्भर करता है कि अनुरोध करने वाले उपयोगकर्ता की कोर्स में क्या भूमिका है. अगर उपयोगकर्ता छात्र या छात्रा है, तो इनमें से किसी एक स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.me.readonlyhttps://www.googleapis.com/auth/classroom.coursework.me
अगर उपयोगकर्ता शिक्षक या डोमेन एडमिन है, तो इनमें से किसी एक स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.students.readonlyhttps://www.googleapis.com/auth/classroom.coursework.students
किसी CourseWork को वापस पाने की अनुमति होने का मतलब यह नहीं है कि आपको कॉन्टेंट या कॉन्टेंट के मेटाडेटा को ऐक्सेस करने की अनुमति भी मिल गई है. इसका मतलब यह है कि अगर एडमिन, कोर्स का सदस्य नहीं है, तो हो सकता है कि उसे अटैच की गई Drive फ़ाइल का टाइटल न दिखे.
छात्र-छात्राओं के जवाब मैनेज करना
StudentSubmission रिसॉर्स, किसी छात्र या छात्रा के CourseWork के लिए किए गए काम को दिखाता है. इस संसाधन में, काम से जुड़ा मेटाडेटा शामिल होता है. जैसे, काम की स्थिति और ग्रेड. जब कोई नया CourseWork बनाया जाता है, तब हर छात्र-छात्रा के लिए एक StudentSubmission अपने-आप बन जाता है.
यहां दिए गए सेक्शन में, छात्र-छात्राओं के जवाबों को मैनेज करने के लिए की जाने वाली सामान्य कार्रवाइयों के बारे में बताया गया है.
छात्र-छात्राओं के जवाब वापस पाना
छात्र-छात्राएं अपने सबमिट किए गए असाइनमेंट वापस पा सकते हैं. शिक्षक, अपने कोर्स में शामिल सभी छात्र-छात्राओं के सबमिट किए गए असाइनमेंट वापस पा सकते हैं. साथ ही, डोमेन एडमिन अपने डोमेन में शामिल सभी छात्र-छात्राओं के सबमिट किए गए असाइनमेंट वापस पा सकते हैं. हर StudentSubmission को एक आइडेंटिफ़ायर असाइन किया जाता है. अगर आपको आइडेंटिफ़ायर पता है, तो सबमिशन वापस पाने के लिए courses.courseWork.studentSubmissions.get का इस्तेमाल करें.
कुछ शर्तों को पूरा करने वाले सभी StudentSubmission संसाधन पाने के लिए, courses.courseWork.studentSubmissions.list तरीके का इस्तेमाल करें. जैसा कि यहां दिए गए उदाहरण में दिखाया गया है:
Java
Python
किसी छात्र-छात्रा से जुड़े StudentSubmission संसाधन पाने के लिए, StudentSubmission पैरामीटर तय करें. इसका उदाहरण यहां दिया गया है:userId
Java
Python
छात्र-छात्राओं की पहचान यूनीक आईडी या ईमेल पते से की जाती है. यह जानकारी Student संसाधन में मौजूद होती है. मौजूदा उपयोगकर्ता, "me" शॉर्टहैंड का इस्तेमाल करके भी अपने आईडी का रेफ़रंस दे सकता है.
किसी कोर्स में मौजूद सभी असाइनमेंट के लिए, छात्र-छात्राओं के सबमिट किए गए काम को भी वापस पाया जा सकता है. इसके लिए, courseWorkId के तौर पर लिटरल "-" का इस्तेमाल करें. जैसा कि इस सैंपल में दिखाया गया है:
Java
service.courses().courseWork().studentSubmissions()
.list(courseId, "-")
.set("userId", userId)
.execute();
Python
service.courses().courseWork().studentSubmissions().list(
courseId=<course ID or alias>,
courseWorkId='-',
userId=<user ID>).execute()
ज़रूरी स्कोप, इस बात पर निर्भर करता है कि अनुरोध करने वाले उपयोगकर्ता की कोर्स में क्या भूमिका है. अगर उपयोगकर्ता शिक्षक या डोमेन एडमिन है, तो इस स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.students.readonlyhttps://www.googleapis.com/auth/classroom.coursework.students
अगर उपयोगकर्ता छात्र या छात्रा है, तो इस स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.me.readonlyhttps://www.googleapis.com/auth/classroom.coursework.me
किसी StudentSubmission को वापस पाने की अनुमति होने का मतलब यह नहीं है कि आपको अटैचमेंट या अटैचमेंट के मेटाडेटा को ऐक्सेस करने की अनुमति भी मिल गई है. इसका मतलब यह है कि अगर कोई एडमिन कोर्स का सदस्य नहीं है, तो हो सकता है कि उसे अटैच की गई Drive फ़ाइल का टाइटल न दिखे.
छात्र-छात्राओं के जवाब में अटैचमेंट जोड़ना
किसी छात्र या छात्रा के सबमिट किए गए असाइनमेंट में लिंक अटैच किए जा सकते हैं. इसके लिए, Link, DriveFile या YouTubeVideo संसाधन अटैच करें. ऐसा courses.courseWork.studentSubmissions.modifyAttachments की मदद से किया जाता है. यहां दिए गए उदाहरण में इसे दिखाया गया है:
Java
Python
Link अटैचमेंट, टारगेट url के हिसाब से तय होता है; Classroom, title और थंबनेल इमेज (thumbnailUrl) को अपने-आप फ़ेच करता है. StudentSubmissions में अटैच किए जा सकने वाले मटीरियल के बारे में जानने के लिए, Material देखें.
StudentSubmission में बदलाव सिर्फ़ कोर्स के शिक्षक या उस छात्र/छात्रा के पास होता है जिसके पास इसका मालिकाना हक है. Materials सिर्फ़ तब अटैच किया जा सकता है, जब StudentSubmission का CourseWorkType ASSIGNMENT हो.
ज़रूरी स्कोप, इस बात पर निर्भर करता है कि अनुरोध करने वाले उपयोगकर्ता की कोर्स में क्या भूमिका है. अगर उपयोगकर्ता शिक्षक है, तो इस स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.students
अगर उपयोगकर्ता छात्र या छात्रा है, तो इस स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.me