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

पुष्टि करने की प्रोसेस सेट अप करने के बाद, Domain Shared Contacts API का इस्तेमाल किया जा सकता है, ताकि 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 एम्फ़ीबियस बुल्व्ड माउंटेन व्यू.
  2. इस एंट्री को पब्लिश करने के लिए, इसे संपर्क सूची वाले फ़ीड के यूआरएल पर भेजें:

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

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

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

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

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

अगले चरण