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