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