Google Classroom में छात्र-छात्राओं और शिक्षकों की भूमिकाएं, किसी कोर्स में उपयोगकर्ता की भूमिका को दिखाती हैं. किसी उपयोगकर्ता को एक कोर्स में शिक्षक और दूसरे कोर्स में छात्र/छात्रा के तौर पर असाइन किया जा सकता है. "छात्र-छात्रा" या "शिक्षक-शिक्षिका" पदनाम, किसी खास कोर्स में किसी उपयोगकर्ता के लिए अनुमतियों के सेट को दिखाता है.
- छात्र/छात्राएं
Studentरिसॉर्स, छात्र या छात्रा के तौर पर रजिस्टर किए गए उपयोगकर्ता को दिखाता हैकिसी खास कोर्स में. छात्र-छात्राओं को कोर्स और शिक्षकों की जानकारी देखने की अनुमति होती है.
- शिक्षक
Teacherसंसाधन, किसी ऐसे उपयोगकर्ता को दिखाता है जो कोई खास कोर्स पढ़ाता है. शिक्षकों को कोर्स की जानकारी देखने और उसमें बदलाव करने की अनुमति होती है. वे शिक्षकों और छात्र-छात्राओं की सूची देख सकते हैं. साथ ही, अतिरिक्त शिक्षकों और छात्र-छात्राओं को मैनेज कर सकते हैं. हर कोर्स का एक मुख्य शिक्षक या कोर्स का मालिक होता है. यह ऐसा शिक्षक होता है जो कोर्स के मालिकाना हक को ट्रांसफ़र करने जैसी सेटिंग मैनेज कर सकता है.
छात्र-छात्राओं और शिक्षकों की पहचान, उपयोगकर्ता के यूनीक आईडी या ईमेल पते से की जाती है. यह जानकारी, Directory API से मिलती है.
मौजूदा उपयोगकर्ता, "me" शॉर्टहैंड का इस्तेमाल करके भी अपने आईडी का रेफ़रंस दे सकता है.
Classroom API का इस्तेमाल करके, सीधे तौर पर मैनेज करने की अनुमतियां
Classroom API का इस्तेमाल करके, सीधे तौर पर कोर्स में उपयोगकर्ताओं को जोड़ने या हटाने के लिए, एडमिन, छात्र-छात्राओं, और शिक्षकों के पास अलग-अलग अनुमतियां होती हैं.
एडमिन
अगर ये शर्तें पूरी होती हैं, तो डोमेन एडमिन के पास न्योता भेजने की प्रोसेस को स्किप करने और सीधे तौर पर छात्र-छात्राओं और शिक्षकों को किसी कोर्स में जोड़ने की अनुमति होती है:
- जिस उपयोगकर्ता को जोड़ा जा रहा है वह एडमिन के डोमेन का हिस्सा है.
- कोर्स का मुख्य शिक्षक या मालिक, एडमिन के डोमेन का हिस्सा होता है.
एडमिन के डोमेन से बाहर के उपयोगकर्ताओं या कोर्स के लिए, ऐप्लिकेशन को उपयोगकर्ता की सहमति लेनी होगी. इसके लिए, उन्हें invitations.create तरीके से न्योता भेजना होगा.
छात्र/छात्राएं
छात्र-छात्राएं, students.create को कॉल करके और कोर्स का enrollmentCode बताकर, खुद को किसी कोर्स में जोड़ सकते हैं. enrollmentCode, कोर्स के लिए यूनीक आइडेंटिफ़ायर है. यह Course रिसॉर्स में शामिल होता है. Classroom के वेब ऐप्लिकेशन में, enrollmentCode स्ट्रीम टैब और कोर्स की जानकारी वाले पेज पर उपलब्ध होता है.
शिक्षक
शिक्षक, उपयोगकर्ताओं को सीधे तौर पर किसी कोर्स में नहीं जोड़ सकते. उन्हें छात्र-छात्राओं और अन्य शिक्षकों को कोर्स में शामिल होने का न्योता भेजने के लिए, invitations.create तरीके का इस्तेमाल करना होगा.
इस टेबल में बताया गया है कि Teacher और Student संसाधनों के लिए, कौनसे उपयोगकर्ता create और delete तरीकों का इस्तेमाल करके अनुरोध कर सकते हैं.
| व्यवस्थापक | शिक्षक | छात्र/छात्रा | |
|---|---|---|---|
CreateTeacher |
✔️ | ✖️ | ✖️ |
DeleteTeacher |
✔️ | ✔️ | ✖️ |
CreateStudent |
✔️ | ✖️ | ✔️ 1 |
DeleteStudent |
✔️ | ✔️ | ✔️ 2 |
1 कोई छात्र या छात्रा, खुद को सिर्फ़ एक कोर्स में जोड़ सकता है.
2 कोई छात्र या छात्रा सिर्फ़ खुद को किसी कोर्स से हटा सकता है.
शिक्षकों को मैनेज करना
डोमेन एडमिन, अपने डोमेन के शिक्षकों को सीधे तौर पर teachers.create वाले कोर्स में जोड़ सकते हैं. इसका उदाहरण यहां दिया गया है:
.NET
Java
PHP
Python
सह-शिक्षक, teachers.delete तरीके का इस्तेमाल करके, किसी कोर्स से अन्य शिक्षकों को हटा सकते हैं. इससे सिर्फ़ उस शिक्षक को कोर्स से हटाया जाता है जिसे आपने चुना है. इससे अन्य कोर्स में शिक्षक के तौर पर उसकी भूमिका या उसकी उपयोगकर्ता प्रोफ़ाइल पर कोई असर नहीं पड़ता.
कोर्स के मालिकों को मैनेज करना
डोमेन एडमिन, शिक्षकों के बीच कोर्स का मालिकाना हक ट्रांसफ़र कर सकते हैं. अहम जानकारी के लिए, कोर्स के मालिक की जानकारी अपडेट करना सेक्शन देखें.
छात्र-छात्राओं को मैनेज करना
डोमेन एडमिन, students.create तरीके का इस्तेमाल करके, अपने डोमेन में शामिल छात्र-छात्राओं को सीधे तौर पर जोड़ सकते हैं. अगर कोई छात्र या छात्रा सीधे तौर पर किसी कोर्स में शामिल हो रहा है, तो enrollmentCode ज़रूरी है.
.NET
Java
PHP
Python
students.delete तरीके का इस्तेमाल करके किसी छात्र-छात्रा को कोर्स से हटाने पर, उसे सिर्फ़ उस कोर्स से हटाया जाता है. इससे दूसरे कोर्स में उसके रजिस्ट्रेशन या उसकी उपयोगकर्ता प्रोफ़ाइल पर कोई असर नहीं पड़ता.
किसी उपयोगकर्ता के कोर्स वापस पाना
किसी छात्र-छात्रा या शिक्षक के लिए कोर्स की सूची पाने के लिए, courses.list को कॉल करें और उपयोगकर्ता का studentId या teacherId डालें.
एक ही courses.list() अनुरोध में, studentId और teacherId, दोनों को सेट नहीं किया जा सकता. किसी शिक्षक और छात्र-छात्रा के नाम पर रजिस्टर किए गए कोर्स की सूची पाने के लिए, हर उपयोगकर्ता के लिए अलग-अलग courses.list() अनुरोध करें. इसके बाद, नतीजों के दोनों सेट का इंटरसेक्शन ढूंढें.
किसी उपयोगकर्ता की प्रोफ़ाइल वापस पाना
किसी उपयोगकर्ता की प्रोफ़ाइल (आईडी और नाम) को वापस पाने के लिए, userProfiles.get को कॉल करें. इसके लिए, उपयोगकर्ता का आईडी, ईमेल पता या अनुरोध करने वाले उपयोगकर्ता के लिए "me" का इस्तेमाल करें. emailAddress फ़ील्ड को वापस पाने के लिए, आपको classroom.profile.emails स्कोप को शामिल करना होगा.
जवाब में मिला id, Directory API Users संसाधन से मेल खाता है. इसमें studentId या teacherId शामिल है.