Classroom के यूज़र इंटरफ़ेस (यूआई) में, पांच तरह के क्लासवर्क: असाइनमेंट,
क्विज़ वाले असाइनमेंट, छोटे जवाब वाले सवाल, कई विकल्प वाले सवाल, और
मटीरियल. फ़िलहाल, Classroom API इन तीन टाइप के साथ काम करता है, जो
एपीआई के लिए, इन्हें CourseWorkType
कहा जाता है: असाइनमेंट, छोटा जवाब
और कई विकल्प वाले सवाल शामिल करें.
इस सुविधा को ऐक्सेस करने के लिए, कोर्सवर्क से जुड़े संसाधन, जो उस असाइनमेंट या सवाल के बारे में बताती है जिसे छात्र-छात्राओं को असाइन किया गया है किसी खास कोर्स से जुड़ा कॉन्टेंट, जैसे कि बकाया तारीख या ज़्यादा से ज़्यादा स्कोर.
कोर्सवर्क संसाधन के अलावा, आप पूरे किए गए असाइनमेंट प्रबंधित कर सकते हैं
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
फ़ील्ड को
संबंधित UTC समय. पूरा होने की तारीख, आने वाले समय की होनी चाहिए.
असाइनमेंट और सवाल वापस पाएं
आपके पास यहां के छात्र-छात्राओं और शिक्षकों के लिए, असाइनमेंट और सवाल वापस पाने का विकल्प है संबंधित कोर्स या डोमेन एडमिन से संपर्क कर सकते हैं. किसी खास यूआरएल को वापस पाने के लिए असाइनमेंट या सवाल के लिए, course.courseWork.get का इस्तेमाल करें. सभी को वापस पाने के लिए असाइनमेंट या सवाल (जो कुछ शर्तों से मेल खाते हों) का इस्तेमाल करें 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
.
पाने के लिए, courses.courseWork.studentSubmissions.list
तरीके का इस्तेमाल करें
StudentSubmission
ऐसे संसाधन जो कुछ शर्तों को पूरा करते हैं, जैसा कि
निम्न नमूना:
Java
Python
किसी खास छात्र/छात्रा से जुड़े StudentSubmission
संसाधन वापस पाएं
userId
पैरामीटर तय करते हुए, जैसा कि नीचे दिए गए नमूने में दिखाया गया है:
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
छात्र/छात्रा के जवाब की स्थिति मैनेज करें
किसी छात्र/छात्रा का जवाब सबमिट नहीं किया जा सकता, सबमिट किया जा सकता है या वापस किया जा सकता है. राज्य फ़ील्ड
में StudentSubmission
मौजूदा स्थिति को दिखाता है. राज्य बदलने के लिए, इस नंबर पर कॉल करें
नीचे दिए गए तरीकों में से कोई एक तरीका अपनाएं:
courses.courseWork.studentSubmissions.turnIn
courses.courseWork.studentSubmissions.return
courses.courseWork.studentSubmissions.reclaim
इन सभी तरीकों में, एक खाली बॉडी लेनी होती है. उदाहरण:
Java
Python
service.courses().courseWork().studentSubmission().turnIn(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
body={}).execute()
जिस छात्र/छात्रा के पास StudentSubmission
का मालिकाना हक है, सिर्फ़ वह उसे सबमिट कर सकता है या उस पर फिर से दावा कर सकता है.
सिर्फ़ सबमिट किए गए सबमिशन पर फिर से दावा किया जा सकता है. पाठ्यक्रम के शिक्षक केवल
StudentSubmission
का स्टेटस 'चालू है' पर सेट है.
छात्र-छात्राओं के जवाबों को ग्रेड करें
ग्रेड स्टोर करने के लिए, StudentSubmission
संसाधन में दो फ़ील्ड होते हैं:
assignedGrade
, जो छात्र-छात्राओं को रिपोर्ट किया गया ग्रेड है. साथ ही, draftGrade
,
जो अस्थायी ग्रेड है. यह सिर्फ़ शिक्षकों को दिखता है. ये फ़ील्ड अपडेट किए गए हैं
फ़ील्ड मास्क के साथ courses.courseWork.studentSubmissions.patch
का इस्तेमाल किया जा रहा है
इसमें सही फ़ील्ड शामिल हैं, जैसा कि नीचे दिए गए सैंपल में दिखाया गया है.
Java
Python
studentSubmission = {
'assignedGrade': 99,
'draftGrade': 80
}
service.courses().courseWork().studentSubmissions().patch(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
updateMask='assignedGrade,draftGrade',
body=studentSubmission).execute()
Classroom के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करने के दौरान, शिक्षक तब तक ग्रेड असाइन नहीं कर सकते, जब तक कि वे ने पहले एक अधूरे ग्रेड को सेव किया हो. असाइन किया गया ग्रेड, इन्हें वापस किया जा सकता है छात्र/छात्रा. ऐप्लिकेशन को भी इसी तरीके से काम करना होगा. आपका ऐप्लिकेशन ये काम कर सकता है: किसी छात्र/छात्रा के असाइनमेंट को इन दो में से किसी एक तरीके से ग्रेड देना होगा:
सिर्फ़
draftGrade
असाइन करें. उदाहरण के लिए, यह उपयोगी है, जिससे शिक्षक ग्रेड को फ़ाइनल करने से पहले, उनकी मैन्युअल तौर पर समीक्षा करें. छात्र-छात्राएं अधूरे ग्रेड नहीं देख सकते.किसी असाइनमेंट को पूरी तरह से ग्रेड देने के लिए,
draftGrade
औरassignedGrade
, दोनों असाइन करें.
असाइन किए गए ग्रेड की सूची
कोर्सवर्क के किसी खास आइटम के लिए सभी ग्रेड की सूची बनाने के लिए, यहां जाएं:
courses.courseWork.studentSubmissions.list
तरीके का रिस्पॉन्स ऑब्जेक्ट:
Java
Python
response = coursework.studentSubmissions().list(
courseId=course_id,
courseWorkId=coursework_id,
pageSize=10).execute()
submissions.extend(response.get('studentSubmissions', []))
if not submissions:
print('No student submissions found.')
print('Student Submissions:')
for submission in submissions:
print(f"Submitted at:"
f"{(submission.get('userId'), submission.get('assignedGrade'))}")