कोर्स के उपनाम का इस्तेमाल करके, कोर्स को किसी दूसरे नाम से रेफ़र किया जा सकता है. कोर्स के एलियास, Google Classroom के कोर्स आइडेंटिफ़ायर और बाहरी कोर्स आइडेंटिफ़ायर के बीच मैपिंग के तौर पर काम कर सकते हैं. उदाहरण के लिए, छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम (एसआईएस) से कोर्स आईडी मैच करने के लिए, कोर्स का उपनाम सेट किया जा सकता है.
कोर्स के उपनाम के दो फ़ॉर्म होते हैं: डोमेन-वाइड और प्रोजेक्ट-वाइड.
पूरे डोमेन के लिए इस्तेमाल किए जाने वाले ईमेल पते के उपनाम में
d:
प्रीफ़िक्स का इस्तेमाल किया जाता है. इन्हें Classroom API का इस्तेमाल करने वाला कोई भी व्यक्ति देख सकता है. डोमेन नेमस्पेस का इस्तेमाल, ऐसे एलियास बनाने के लिए किया जाता है जिनका ऐक्सेस सभी उपयोगकर्ताओं के पास होना चाहिए. हालांकि, ये एलियास किसी एक प्रोग्राम के लिए नहीं होते. उदाहरण के लिए, किसी कोर्स की वैकल्पिक लिस्टिंग, जैसे कि MATH 127 और COMSCI 127, को डोमेन नेमस्पेस में बनाया जाना चाहिए. डोमेन नेमस्पेस में उपनाम सिर्फ़ डोमेन एडमिन बना सकते हैं. हालांकि, ये डोमेन के सभी उपयोगकर्ताओं को दिखते हैं.प्रोजेक्ट-वाइड एलियास में
p:
प्रीफ़िक्स का इस्तेमाल किया जाता है. इन्हें सिर्फ़ उस Google Cloud प्रोजेक्ट से देखा और इस्तेमाल किया जा सकता है जिसने इन्हें बनाया है. डेवलपर प्रोजेक्ट नेमस्पेस, किसी ऐप्लिकेशन से जुड़े उपनामों को मैनेज करने के लिए उपयोगी होता है. उदाहरण के लिए, अगर कोई ऐप्लिकेशन कोर्स के लिए दूसरे आइडेंटिफ़ायर का इस्तेमाल करता है, तो वह अपने आइडेंटिफ़ायर को Classroom के कोर्स से मैप करने के लिए, उपनाम बना सकता है. इस नेमस्पेस में बनाए गए उपनाम, किसी खास Google Cloud प्रोजेक्ट से जुड़े होते हैं. किसी ऐप्लिकेशन का कोई भी उपयोगकर्ता, उस ऐप्लिकेशन के डेवलपर प्रोजेक्ट के नेमस्पेस में उपनाम बना सकता है और उन्हें देख सकता है.
Classroom API के किसी भी एंडपॉइंट के लिए, Classroom कोर्स आईडी की जगह कोर्स के उपनाम का इस्तेमाल किया जा सकता है. इसका मतलब है कि इस एलियास का इस्तेमाल, कोर्स और रोस्टर की जानकारी को पढ़ने और उसमें बदलाव करने के लिए किया जा सकता है.
छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम के साथ सिंक करने के लिए, किसी दूसरे ईमेल पते का इस्तेमाल करना
किसी कोर्स के लिए एसआईएस के इंटरनल आइडेंटिफ़ायर को, कोर्स के लिए पूरे डोमेन में इस्तेमाल होने वाले अन्य नाम के तौर पर रजिस्टर किया जा सकता है. इस तरह, एसआईएस और Classroom, दोनों के साथ इंटिग्रेट करने वाला कोई भी डेवलपर, Classroom के डेटा के साथ इंटरैक्ट करने के लिए एसआईएस आइडेंटिफ़ायर का इस्तेमाल कर सकता है.
अगर आपने किसी एसआईएस से कोई कोर्स बनाया है या किसी कोर्स को एसआईएस से लिंक किया है, तो हमारा सुझाव है कि एसआईएस के कोर्स आईडी को कोर्स के एलियास के तौर पर इस्तेमाल करें. courses.create()
तरीके का इस्तेमाल करके कोर्स बनाते समय, अनुरोध के id
फ़ील्ड में उपनाम दिया जा सकता है. अगर उपनाम पहले से मौजूद है, तो कोर्स नहीं बनाया जा सकेगा. साथ ही, 409 ALREADY_EXISTS
गड़बड़ी दिखेगी. अगर सिंक प्रोग्राम में कोई समस्या है, तो इससे डुप्लीकेट कोर्स बनने से रोका जा सकता है.
उदाहरण के लिए, अगर हम मान लें कि एसआईएस का नाम school
है और एसआईएस की ओर से किसी खास कोर्स के लिए इस्तेमाल किया गया इंटरनल आइडेंटिफ़ायर math_101
है, तो d:school_math_101
के तौर पर कोई उपनाम बनाया जा सकता है.
किसी नए कोर्स के लिए उपनाम जोड़ना
किसी नए कोर्स के लिए उपनाम जोड़ने के लिए, courses.create()
अनुरोध करते समय, course.id
को उपनाम पर सेट करें.
Apps Script
Java
Python
किसी मौजूदा कोर्स के लिए कोई दूसरा नाम जोड़ना
किसी मौजूदा कोर्स में उपनाम जोड़ने के लिए, alias
फ़ील्ड सेट करें और courses.aliases.create()
तरीके का इस्तेमाल करें.
Apps Script
Java
Python
कोर्स के दूसरे नाम वापस पाना
courses.aliases.list()
तरीके का इस्तेमाल करके, किसी कोर्स के लिए उपनामों को वापस पाया जा सकता है. इसका तरीका यहां दिए गए सैंपल में दिखाया गया है:
.NET
Java
Python