कोर्स के उपनाम का इस्तेमाल करके, कोर्स को किसी दूसरे नाम से रेफ़र किया जा सकता है. कोर्स के दूसरे नाम, Google Classroom के कोर्स आइडेंटिफ़ायर और बाहरी कोर्स आइडेंटिफ़ायर के बीच मैपिंग के तौर पर काम कर सकते हैं. उदाहरण के लिए, छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम (एसआईएस) से कोर्स आईडी से मैच करने के लिए, कोर्स का कोई दूसरा नाम सेट किया जा सकता है.
कोर्स के उपनाम के दो फ़ॉर्म होते हैं: डोमेन-वाइड और प्रोजेक्ट-वाइड.
पूरे डोमेन के लिए उपनाम,
d:
के प्रीफ़िक्स का इस्तेमाल करते हैं. इन्हें Classroom API का इस्तेमाल करने वाला कोई भी व्यक्ति देख सकता है. डोमेन नेमस्पेस, ऐसे उपनाम बनाने के लिए मददगार होता है जिनका ऐक्सेस सभी उपयोगकर्ताओं को चाहिए, लेकिन जो किसी एक प्रोग्राम के लिए खास नहीं होते. उदाहरण के लिए, किसी कोर्स के लिए वैकल्पिक लिस्टिंग, जैसे कि MATH 127 और COMSCI 127, डोमेन नेमस्पेस में बनाई जानी चाहिए. डोमेन नेमस्पेस में सिर्फ़ डोमेन एडमिन ही उपनाम बना सकते हैं. हालांकि, ये उपनाम डोमेन के सभी उपयोगकर्ताओं को दिखते हैं.पूरे प्रोजेक्ट के लिए उपनाम,
p:
के प्रीफ़िक्स का इस्तेमाल करते हैं. इन्हें सिर्फ़ वह Google Cloud प्रोजेक्ट देख सकता है और इस्तेमाल कर सकता है जिसने इन्हें बनाया है. डेवलपर प्रोजेक्ट नेमस्पेस, किसी ऐप्लिकेशन के लिए खास अलीएस मैनेज करने में मददगार होता है. उदाहरण के लिए, कोई ऐसा ऐप्लिकेशन जो कोर्स के लिए वैकल्पिक आइडेंटिफ़ायर का इस्तेमाल करता है, अपने आइडेंटिफ़ायर को Classroom के कोर्स से मैप करने के लिए, दूसरे नाम बना सकता है. इस नेमस्पेस में बनाए गए उपनाम, किसी खास Google Cloud प्रोजेक्ट से जुड़े होते हैं. किसी ऐप्लिकेशन का कोई भी उपयोगकर्ता, उस ऐप्लिकेशन के डेवलपर प्रोजेक्ट के नेमस्पेस में उपनाम बना सकता है और उन्हें देख सकता है.
Classroom API के किसी भी एंडपॉइंट के लिए, Classroom कोर्स आईडी के बजाय कोर्स के उपनाम का इस्तेमाल किया जा सकता है. इसका मतलब है कि कोर्स और रोस्टर की जानकारी को पढ़ने और उसमें बदलाव करने के लिए, उपनाम का इस्तेमाल किया जा सकता है.
छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम के साथ सिंक करने के लिए, किसी दूसरे नाम का इस्तेमाल करना
किसी कोर्स के लिए, एसआईएस का इंटरनल आइडेंटिफ़ायर, कोर्स के लिए डोमेन-वाइड उपनाम के तौर पर रजिस्टर किया जा सकता है. इस तरह, SIS और Classroom, दोनों के साथ इंटिग्रेट करने वाला कोई भी डेवलपर, Classroom के डेटा के साथ इंटरैक्ट करने के लिए SIS आइडेंटिफ़ायर का इस्तेमाल कर सकता है.
अगर किसी एसआईएस से कोर्स बनाया जाता है या किसी कोर्स को एसआईएस से लिंक किया जाता है, तो हमारा सुझाव है कि एसआईएस के कोर्स आईडी का इस्तेमाल, कोर्स के उपनाम के तौर पर किया जाए. 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