शेयर किए गए संपर्क बनाना

पुष्टि करने की सुविधा सेट अप करने के बाद, डोमेन में शेयर किए गए संपर्क को मैनेज करने वाले एपीआई का इस्तेमाल करके, Google Workspace डोमेन में शेयर किए गए नए संपर्क की जानकारी पब्लिश की जा सकती है. शेयर किए गए संपर्कों को ईमेल पते के अपने-आप भरने की सुविधा और संपर्क मैनेजर में दिखने में 24 घंटे लग सकते हैं.

  1. शेयर किए गए उस संपर्क का एक्सएमएल वर्शन बनाएं जिसे आपको संपर्क टाइप के ऐटम <entry> एलिमेंट के तौर पर पब्लिश करना है. यह इस तरह दिख सकता है:

    <atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
        xmlns:gd='http://schemas.google.com/g/2005'>
      <atom:category scheme='http://schemas.google.com/g/2005#kind'
        term='http://schemas.google.com/contact/2008#contact' />
      <gd:name>
         <gd:givenName>FIRST_NAME</gd:givenName>
         <gd:familyName>LAST_NAME</gd:familyName>
         <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
      </gd:name>
      <atom:content type='text'>NOTES</atom:content>
      <gd:email rel='http://schemas.google.com/g/2005#work'
        primary='true'
        address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' />
      <gd:email rel='http://schemas.google.com/g/2005#home'
        address='SECONDARY_EMAIL_ADDRESS' />
      <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
        primary='true'>
        PRIMARY_PHONE_NUMBER
      </gd:phoneNumber>
      <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
        SECONDARY_PHONE_NUMBER
      </gd:phoneNumber>
      <gd:im address='INSTANT_MESSAGING_ADDRESS'
        protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
        primary='true'
        rel='http://schemas.google.com/g/2005#home' />
      <gd:structuredPostalAddress
          rel='http://schemas.google.com/g/2005#work'
          primary='true'>
        <gd:city>CITY_NAME</gd:city>
        <gd:street>ADDRESS</gd:street>
        <gd:region>REGION_NAME</gd:region>
        <gd:postcode>POST_CODE</gd:postcode>
        <gd:country>COUNTRY_NAME</gd:country>
        <gd:formattedAddress>
          FORMATTED_ADDRESS
        </gd:formattedAddress>
      </gd:structuredPostalAddress>
    </atom:entry>

    इनकी जगह ये डालें:

    • FIRST_NAME: शेयर किए गए संपर्क का नाम—उदाहरण के लिए, ऐलेक्स.
    • LAST_NAME: शेयर किए गए संपर्क का आखिरी नाम—उदाहरण के लिए, किम.
    • PRIMARY_EMAIL_ADDRESS: शेयर किए गए संपर्क का पसंदीदा ईमेल पता—उदाहरण के लिए, alk@gmail.com.
    • PREFERRED_NAME: उपयोगकर्ता के लिए दिखाया जाने वाला नाम—उदाहरण के लिए, ऐलेक्स किम
    • SECONDARY_EMAIL_ADDRESS: शेयर किए गए संपर्क का दूसरा ईमेल पता—उदाहरण के लिए, alk@example.org.
    • PRIMARY_PHONE_NUMBER: शेयर किए गए संपर्क के लिए, पसंदीदा फ़ोन नंबर—उदाहरण के लिए, (800) 555-0100.
    • SECONDARY_PHONE_NUMBER: शेयर किए गए संपर्क का दूसरा फ़ोन नंबर—उदाहरण के लिए, (800) 555-0101.
    • INSTANT_MESSAGING_ADDRESS: शेयर किए गए संपर्क की इंस्टैंट मैसेजिंग की जानकारी से जुड़ा ईमेल पता. उदाहरण के लिए, alk@gmail.com.
    • CITY_NAME: शेयर किए गए संपर्क का शहर का नाम—उदाहरण के लिए, माउंटेन व्यू.
    • ADDRESS: शेयर किए गए संपर्क का घर का पता—उदाहरण के लिए, 1600 Amphibious Blvd.
    • REGION_NAME: शेयर किए गए संपर्क का राज्य या प्रांत—उदाहरण के लिए, CA.
    • POST_CODE: शेयर किए गए संपर्क का ज़िप या पिन कोड—उदाहरण के लिए, 94045.
    • COUNTRY_NAME: शेयर किए गए संपर्क का देश—उदाहरण के लिए, अमेरिका.
    • FORMATTED_ADDRESS: शेयर किए गए संपर्क का पता, जिसे उसके देश या इलाके के हिसाब से फ़ॉर्मैट किया गया हो. उदाहरण के लिए, 1800 Amphibious Blvd Mountain View.
  2. इस एंट्री को पब्लिश करने के लिए, इसे संपर्क सूची वाले फ़ीड के यूआरएल पर भेजें:

    1. application/atom+xml कॉन्टेंट टाइप का इस्तेमाल करके, अपने Atom <entry> एलिमेंट को नए POST अनुरोध के मुख्य हिस्से में डालें.
    2. फ़ीड के यूआरएल पर POST अनुरोध भेजें.

    उदाहरण के लिए, डोमेन के शेयर किए गए संपर्क को example.com की सूची में जोड़ने के लिए, नई एंट्री के साथ POST अनुरोध को इस यूआरएल पर भेजें:

    https://www.google.com/m8/feeds/contacts/example.com/full
    

    Google सर्वर, आपकी भेजी गई एंट्री का इस्तेमाल करके एक संपर्क बनाता है. इसके बाद, HTTP 201 CREATED स्टेटस कोड के साथ-साथ <entry> एलिमेंट के तौर पर नए संपर्क की कॉपी दिखाता है. रिटर्न की गई एंट्री वही होती है जो आपने भेजी थी. हालांकि, इसमें सर्वर से जोड़े गए कई एलिमेंट भी होते हैं, जैसे कि <id> एलिमेंट.

    अगर आपका अनुरोध पूरा नहीं होता है, तो हो सकता है कि Google आपको कोई दूसरा स्टेटस कोड दिखाए. स्टेटस कोड के बारे में जानकारी के लिए, Google Data API प्रोटोकॉल का रेफ़रंस दस्तावेज़ देखें.

अगले चरण