REST Resource: courses.aliases

रिसॉर्स: CourseAlias

किसी कोर्स के लिए वैकल्पिक आइडेंटिफ़ायर.

किसी कोर्स की खास पहचान करने के लिए, उसका कोई दूसरा नाम दिया जाता है. यह इनमें से किसी एक स्कोप में यूनीक होना चाहिए:

  • डोमेन: डोमेन के दायरे वाला कोई दूसरा नाम, उस डोमेन के सभी उपयोगकर्ताओं को दिखता है जिसने उसे बनाया है. इसे सिर्फ़ डोमेन एडमिन बना सकता है. डोमेन के दायरे वाले किसी उपनाम का इस्तेमाल तब किया जाता है, जब किसी कोर्स में Classroom से बाहर का आइडेंटिफ़ायर हो.

  • प्रोजेक्ट: प्रोजेक्ट के दायरे में आने वाला उपनाम, Developer Console के उस प्रोजेक्ट आईडी का इस्तेमाल करके किए गए किसी भी अनुरोध को दिखता है जिसने उपनाम बनाया है. साथ ही, इसे किसी भी प्रोजेक्ट से बनाया जा सकता है. प्रोजेक्ट के दायरे वाले उपनाम का इस्तेमाल अक्सर तब किया जाता है, जब किसी ऐप्लिकेशन में अन्य आइडेंटिफ़ायर हों. डेटा ट्रांसफ़र न हो पाने की स्थिति में, डुप्लीकेट कोर्स से बचने के लिए भी किसी रैंडम वैल्यू का इस्तेमाल किया जा सकता है. ऐसा इसलिए, क्योंकि अगर पिछले अनुरोध को स्वीकार कर लिया गया है, तो अनुरोध को फिर से करने पर ALREADY_EXISTS दिखेगा.

JSON के काेड में दिखाना
{
  "alias": string
}
फ़ील्ड
alias

string

उपनाम स्ट्रिंग. स्ट्रिंग के फ़ॉर्मैट से पता चलता है कि किस तरह के उपनाम का स्कोप तय करना है.

  • d:<name>, डोमेन के दायरे वाले किसी अन्य डोमेन नेम को दिखाता है. उदाहरण: d:math_101
  • p:<name> से पता चलता है कि यह प्रोजेक्ट के स्कोप वाला कोई दूसरा नाम है. उदाहरण: p:abc123

इस फ़ील्ड में ज़्यादा से ज़्यादा 256 वर्ण हो सकते हैं.

तरीके

create

किसी कोर्स के लिए दूसरा नाम बनाता है.

delete

किसी कोर्स का उपनाम मिटाता है.

list

किसी कोर्स के लिए, दूसरे नामों की सूची दिखाता है.