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