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