डायरेक्ट्री एपीआई: उपयोगकर्ता के उपनाम

उपयोगकर्ता का दूसरा ईमेल पता बनाना

उपयोगकर्ता का उपनाम एक वैकल्पिक ईमेल पता होता है, जो उसी मेलबॉक्स का उपयोग करता है जिसका उपयोग उपयोगकर्ता प्राथमिक ईमेल पता. उपयोगकर्ता का दूसरा ईमेल पता, उसके डोमेन के डोमेन से अलग किसी दूसरे खाते के डोमेन से जुड़ा हो सकता है इस डोमेन का इस्तेमाल उपयोगकर्ता के प्राइमरी ईमेल पते में होता है. उपयोगकर्ता 24 घंटे के अंदर (अक्सर इससे पहले) काम शुरू करता है इस पते पर भेजे गए ईमेल प्राप्त कर रहा है. एपीआई का इस्तेमाल करने के लिए ज़रूरी है कि डोमेन के मालिकाना हक की पुष्टि हो गई है इससे पहले कि आप उपयोगकर्ता उपनाम बना सकें.

उपयोगकर्ता का दूसरा ईमेल पता बनाने के लिए, नीचे दिए गए POST अनुरोध का इस्तेमाल करें. साथ ही, अनुरोध की अनुमति दें में दी गई अनुमति को शामिल करें. userKey, उपयोगकर्ता का मुख्य ईमेल पता, उपयोगकर्ता id या उपयोगकर्ता का कोई भी अन्य ईमेल पता हो सकता है ईमेल. अनुरोध और रिस्पॉन्स प्रॉपर्टी के लिए, एपीआई का संदर्भ देखें: 

POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases

JSON अनुरोध

JSON का यह अनुरोध, किसी उपयोगकर्ता का उपनाम बनाने के लिए किया गया सैंपल अनुरोध दिखाता है. उपयोगकर्ता liz@example.com है और ईमेल पते के बने होने के बाद, Chica@example.com: 

POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
 अनुरोध के मुख्य हिस्से में उपनाम की नई जानकारी है: 
{  
 "alias": "chica@example.com"
}

सही रिस्पॉन्स मिलने पर एचटीटीपी 201 स्टेटस कोड दिखता है. स्टेटस कोड के साथ-साथ, रिस्पॉन्स नए उपयोगकर्ता उपनाम के लिए प्रॉपर्टी दिखाता है.

किसी उपयोगकर्ता के सभी उपनाम वापस पाएं

सभी डोमेन में किसी उपयोगकर्ता के अन्य डोमेन नेम पाने के लिए, नीचे दिए गए GET अनुरोध का इस्तेमाल करें. साथ ही, अनुमति पाने के अनुरोध में दी गई अनुमति को शामिल करें. userKey, उपयोगकर्ता का मुख्य ईमेल पता, उपयोगकर्ता id या उपयोगकर्ता का कोई भी अन्य ईमेल पता हो सकता है ईमेल. अनुरोध और रिस्पॉन्स प्रॉपर्टी के लिए, एपीआई का संदर्भ देखें: 

GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
 उदाहरण के लिए, यह अनुरोध यूआरआई userKey, liz@example.com के लिए सभी उपनामों को दिखाता है: 
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases

सभी उपयोगकर्ता उपनामों को वर्णमाला के क्रम में लौटाया जाता है. 'सभी उपनामों को फिर से पाएं' के लिए इस्तेमाल किए जाने वाले maxResults क्वेरी स्ट्रिंग या पेज पर नंबर वाले पेज जैसा कोई पेज साइज़ मौजूद नहीं होता है जवाब.

JSON का रिस्पॉन्स

सही रिस्पॉन्स मिलने पर एचटीटीपी 200 स्टेटस कोड दिखता है. स्टेटस कोड के साथ रिस्पॉन्स, उपयोगकर्ता के उपनामों को वर्णमाला के क्रम में दिखाता है. ये उपनाम डोमेन, प्राइमरी डोमेन और खाते में मौजूद अन्य एक से ज़्यादा डोमेन हैं: 

{
"kind": "directory#user#aliases",
"aliases": [
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "chica@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "support@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "help@hr.example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "tickets@jumboinc.com"
 }
]
}

किसी उपयोगकर्ता का दूसरा ईमेल पता मिटाना

किसी उपयोगकर्ता का दूसरा ईमेल पता मिटाने के लिए, नीचे दिए गए DELETE अनुरोध का इस्तेमाल करें और इसमें अनुमति देने के बारे में इसमें बताया गया है अनुरोधों को अनुमति देना. यह कम से कम इतनी जगह ले सकता है: उपनाम को हटाने में 24 घंटे लग सकते हैं. कॉन्टेंट बनाने userKey, उपयोगकर्ता का मुख्य ईमेल पता, उपयोगकर्ता id या इनमें से कोई भी एक हो सकता है उपयोगकर्ता का अन्य नाम' ईमेल. और aliasId अन्य ईमेल पता है किया जा रहा है. हटाया गया. अनुरोध और रिस्पॉन्स प्रॉपर्टी के लिए, एपीआई का संदर्भ. 

DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
 उदाहरण के लिए, यह DELETE अनुरोध userKey, liz@example.com के लिए Chica@example.com उपनाम को मिटा देता है: 
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com

सही रिस्पॉन्स मिलने पर एचटीटीपी 200 स्टेटस कोड दिखता है.