Classroom के यूज़र इंटरफ़ेस (यूआई) में, पांच तरह के क्लासवर्क बनाए जा सकते हैं: असाइनमेंट, क्विज़ असाइनमेंट, कम शब्दों में जवाब देने वाले सवाल, कई विकल्प वाले सवाल, और कॉन्टेंट. फ़िलहाल, Classroom API इनमें से तीन टाइप के सवालों के साथ काम करता है. इन्हें एपीआई के लिए CourseWorkType
कहा जाता है: असाइनमेंट, कम शब्दों में जवाब देने वाले सवाल, और कई विकल्प वाले सवाल.
इस सुविधा को ऐक्सेस करने के लिए, कोर्सवर्क संसाधन का इस्तेमाल किया जा सकता है. यह किसी खास कोर्स में, छात्र-छात्राओं को असाइन किए गए असाइनमेंट या सवाल के बारे में बताता है. इसमें, असाइनमेंट की समयसीमा या ज़्यादा से ज़्यादा स्कोर जैसी अन्य जानकारी और कॉन्टेंट भी शामिल होता है.
CourseWork संसाधन के अलावा, StudentSubmission
संसाधन की मदद से, पूरे हो चुके असाइनमेंट मैनेज किए जा सकते हैं. इन सेक्शन में, इनके बारे में ज़्यादा जानकारी दी गई है.
असाइनमेंट बनाना
कोर्स के शिक्षक के नाम पर ही सिर्फ़ असाइनमेंट बनाए जा सकते हैं. किसी छात्र/छात्रा के नाम पर असाइनमेंट बनाने की कोशिश करने पर, आपको 403 PERMISSION_DENIED
कोड वाली गड़बड़ी का मैसेज दिखेगा. इसी तरह, डोमेन एडमिन उन कोर्स के लिए असाइनमेंट नहीं बना सकते जिन्हें वे नहीं पढ़ाते. एपीआई की मदद से ऐसा करने पर भी, 403 PERMISSION_DENIED
गड़बड़ी का मैसेज दिखेगा.
courses.courseWork.create
तरीके का इस्तेमाल करके असाइनमेंट बनाते समय, लिंक को materials
के तौर पर अटैच किया जा सकता है. इस बारे में यहां दिए गए सैंपल कोड में बताया गया है:
Java
Python
नतीजे में, सर्वर से असाइन किया गया आइडेंटिफ़ायर शामिल होता है. इसका इस्तेमाल, अन्य एपीआई अनुरोधों में असाइनमेंट का रेफ़रंस देने के लिए किया जा सकता है.
Classroom API की मदद से बनाए गए असाइनमेंट में, लिंक किए गए कॉन्टेंट को शामिल करने के लिए, टारगेट यूआरएल की जानकारी देते हुए संसाधन लिंक करें का इस्तेमाल करें. Classroom, टाइटल और थंबनेल इमेज को अपने-आप फ़ेच करता है. Classroom API, Google Drive और YouTube के कॉन्टेंट के साथ भी काम करता है. इन कॉन्टेंट को DriveFile रिसॉर्स या YouTubeVideo रिसॉर्स के साथ उसी तरह शामिल किया जा सकता है जिस तरह किसी फ़ाइल को शामिल किया जाता है.
पेमेंट की आखिरी तारीख बताने के लिए, dueDate
और dueTime
फ़ील्ड में यूटीसी समय सेट करें. पेमेंट की तारीख, आने वाले समय की होनी चाहिए.
असाइनमेंट और सवालों को वापस पाना
आपके पास, उस कोर्स के छात्र-छात्राओं और शिक्षकों के लिए असाइनमेंट और सवालों को वापस पाने का विकल्प है. इसके अलावा, डोमेन एडमिन भी ऐसा कर सकता है. किसी खास असाइनमेंट या सवाल को वापस पाने के लिए, courses.courseWork.get का इस्तेमाल करें. सभी असाइनमेंट या सवालों को वापस पाने के लिए, courses.courseWork.list का इस्तेमाल करें. हालांकि, कुछ शर्तों के हिसाब से मैच करने वाले असाइनमेंट या सवालों को वापस पाने के लिए, courses.courseWork.list का इस्तेमाल करना ज़रूरी नहीं है.
ज़रूरी दायरा, कोर्स में अनुरोध करने वाले उपयोगकर्ता की भूमिका पर निर्भर करता है. अगर उपयोगकर्ता छात्र/छात्रा है, तो इनमें से किसी एक स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
अगर उपयोगकर्ता शिक्षक या डोमेन एडमिन है, तो इनमें से किसी एक स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
किसी असाइनमेंट या सवाल को वापस पाने की अनुमति होने का मतलब यह नहीं है कि आपके पास कॉन्टेंट या कॉन्टेंट के मेटाडेटा को ऐक्सेस करने की अनुमति है. इसका मतलब है कि अगर कोई एडमिन कोर्स का सदस्य नहीं है, तो हो सकता है कि उसे अटैच की गई Drive फ़ाइल का टाइटल न दिखे. अगर आपको एडमिन को उपयोगकर्ता की फ़ाइलों का ऐक्सेस देना है, तो पूरे डोमेन के लिए डेटा का ऐक्सेस देने की गाइड देखें.
छात्र-छात्राओं के जवाब मैनेज करना
StudentSubmission
रिसोर्स से, किसी असाइनमेंट या सवाल के लिए छात्र/छात्रा के किए गए काम और ग्रेड की जानकारी मिलती है. नया सवाल या असाइनमेंट बनाने पर, हर छात्र/छात्रा के लिए StudentSubmission
रिसॉर्स अपने-आप बन जाता है.
यहां दिए गए सेक्शन में, छात्र-छात्राओं के जवाबों को मैनेज करने वाली सामान्य कार्रवाइयों के बारे में बताया गया है.
छात्र-छात्राओं के जवाब पाना
छात्र-छात्राएं अपने सबमिशन वापस पा सकते हैं. शिक्षक, अपने कोर्स में शामिल सभी छात्र-छात्राओं के सबमिशन वापस पा सकते हैं. साथ ही, डोमेन एडमिन अपने डोमेन में शामिल सभी छात्र-छात्राओं के सबमिशन वापस पा सकते हैं. छात्र/छात्रा के हर सबमिशन को एक आइडेंटिफ़ायर असाइन किया जाता है. अगर आपको आइडेंटिफ़ायर पता है, तो उसे वापस पाने के लिए courses.courseWork.studentSubmissions.get
का इस्तेमाल करें.
कुछ शर्तों से मैच करने वाले StudentSubmission
संसाधन पाने के लिए, courses.courseWork.studentSubmissions.list
तरीके का इस्तेमाल करें. इस बारे में यहां दिए गए उदाहरण में बताया गया है:
Java
Python
userId
पैरामीटर की मदद से, किसी खास छात्र के StudentSubmission
संसाधनों को फिर से पाएं. इसका उदाहरण यहां दिया गया है:
Java
Python
Google Admin SDK टूल से मिले यूनीक आईडी या ईमेल पते से, छात्र-छात्राओं की पहचान की जाती है. मौजूदा उपयोगकर्ता, "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.readonly
https://www.googleapis.com/auth/classroom.coursework.students
अगर उपयोगकर्ता छात्र है, तो इस स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
छात्र-छात्राओं के सबमिट किए गए दस्तावेज़ को वापस पाने की अनुमति होने का मतलब यह नहीं है कि आपके पास अटैचमेंट या अटैचमेंट के मेटाडेटा को ऐक्सेस करने की अनुमति है. इसका मतलब है कि अगर कोई एडमिन कोर्स का सदस्य नहीं है, तो हो सकता है कि उसे अटैच की गई Drive फ़ाइल का टाइटल न दिखे. अगर आपको एडमिन को उपयोगकर्ता की फ़ाइलों का ऐक्सेस देना है, तो पूरे डोमेन के लोगों को डेटा का ऐक्सेस दें गाइड देखें.
छात्र के जवाब में अटैचमेंट जोड़ना
छात्र के सबमिशन में लिंक अटैच करने के लिए, Link
, DriveFile
या YouTubeVideo
संसाधन अटैच करें. ऐसा करने के लिए, courses.courseWork.studentSubmissions.modifyAttachments
का इस्तेमाल किया जाता है, जैसा कि नीचे दिए गए सैंपल में दिखाया गया है:
Java
Python
लिंक अटैचमेंट को टारगेट यूआरएल से तय किया जाता है. Classroom, टाइटल और थंबनेल इमेज को अपने-आप फ़ेच कर लेगा. अन्य दस्तावेज़ों के बारे में जानने के लिए, उनके रेफ़रंस पेज पर जाएं.
StudentSubmission
में सिर्फ़ कोर्स का शिक्षक या उस छात्र/छात्रा के पास बदलाव करने का विकल्प होता है जिसके पास उसका मालिकाना हक होता है. Materials
को सिर्फ़ तब अटैच किया जा सकता है, जब छात्र/छात्रा के सबमिशन का CourseWorkType
ASSIGNMENT
हो.
ज़रूरी दायरा, इस बात पर निर्भर करता है कि कोर्स में अनुरोध करने वाले उपयोगकर्ता की भूमिका क्या है. अगर उपयोगकर्ता शिक्षक है, तो इस स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.students
अगर उपयोगकर्ता छात्र है, तो इस स्कोप का इस्तेमाल करें:
https://www.googleapis.com/auth/classroom.coursework.me