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

शेयर किए गए उपयोगकर्ता के संपर्कों का अनुरोध कई तरीकों से किया जा सकता है:

  • शेयर किए गए सभी संपर्क
  • किसी खास शर्त से मैच करने वाले संपर्कों का सेट
  • शेयर किया गया एक संपर्क
  • किसी संपर्क की फ़ोटो

डिफ़ॉल्ट रूप से, फ़ीड में मौजूद एंट्री को क्रम से नहीं लगाया जाता.

शेयर किए गए सभी संपर्कों को ऐक्सेस करना

  1. शेयर किए गए सभी संपर्कों को पाने के लिए, संपर्कों के फ़ीड के यूआरएल पर एचटीटीपी GET अनुरोध भेजें:

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

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

    • DOMAIN: आपके डोमेन का यूआरएल—उदाहरण के लिए, example.com.
    • PROJECTION: प्रोजेक्शन वैल्यू, जो gd:extendedProperty एलिमेंट के बारे में बताती है. इस्तेमाल की जा सकने वाली वैल्यू की सूची देखने के लिए, प्रक्षेपण वैल्यू देखें.

    फ़ीड, HTTP 200 OK स्टेटस कोड और संपर्कों वाला स्टैंडर्ड Atom 1.0 फ़ीड दिखाता है. यहां सिर्फ़ एक एंट्री वाले संपर्कों के फ़ीड का उदाहरण दिया गया है:

    <feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
    xmlns:gd='http://schemas.google.com/g/2005'
    xmlns:gContact='http://schemas.google.com/contact/2008'
    xmlns:batch='http://schemas.google.com/gdata/batch'>
  <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
  <updated>2008-03-05T12:36:38.836Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>example.com's Contacts</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
  <author>
    <name>example.com</name>
    <email>example.com</email>
  </author>
  <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
    Contacts
  </generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
  <entry>
    <id>
      https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
    </id>
    <updated>2008-03-05T12:36:38.835Z</updated>
    <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/contact/2008#contact' />
    <title type='text'>Fitzgerald</title>
    <gd:name>
      <gd:fullName>Fitzgerald</gd:fullName>
    </gd:name>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
      href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
    <link rel='self' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
    <link rel='edit' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
    <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
      primary='true'>
      456
    </gd:phoneNumber>
    <gd:extendedProperty name="pet" value="hamster" />
  </entry>
</feed>

  2. फ़ीड, एक ही जवाब में 10 एमबी से ज़्यादा डेटा नहीं दिखाता. पूरी संपर्क सूची पाने के लिए, रिटर्न किए गए फ़ीड के आगे बढ़ें लिंक पर बार-बार क्लिक करें. ऐसा तब तक करें, जब तक आपको रिटर्न किए गए फ़ीड में वह लिंक न दिखे.

क्वेरी पैरामीटर का इस्तेमाल करके, शेयर किए गए संपर्कों की जानकारी पाना

आपके पास किसी खास शर्त से मैच करने वाले संपर्कों के सेट का अनुरोध करने का विकल्प होता है. जैसे, किसी तारीख के बाद अपडेट किए गए संपर्कों का अनुरोध करना. इसमें पूरे टेक्स्ट वाली क्वेरी या ईमेल पते से किसी संपर्क को ढूंढने की सुविधा उपलब्ध नहीं है. काम करने वाले क्वेरी पैरामीटर की पूरी सूची के लिए, Domain Shared Contacts API की रेफ़रंस गाइड देखें.

  1. तय किए गए पैरामीटर के साथ, संपर्कों के फ़ीड के यूआरएल पर HTTP GET अनुरोध भेजें:

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER

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

    • DOMAIN: आपके डोमेन का यूआरएल—उदाहरण के लिए, example.com.
    • PROJECTION: प्रोजेक्शन वैल्यू, जो gd:extendedProperty एलिमेंट के बारे में बताती है. इस्तेमाल की जा सकने वाली वैल्यू की सूची देखने के लिए, प्रक्षेपण वैल्यू देखें.
    • PARAMETER: काम करने वाले क्वेरी पैरामीटर में से कोई एक. ज़्यादा जानकारी के लिए, Domain Shared Contacts API की रेफ़रंस गाइड देखें.

    उदाहरण के लिए, example.com के लिए 16 मार्च, 2022 के बाद शेयर किए गए डोमेन की सभी संपर्क जानकारी अपडेट करने के लिए, शेयर किए गए डोमेन के संपर्क फ़ीड यूआरएल पर एचटीटीपी अनुरोध भेजें. साथ ही, अनुरोध यूआरएल में updated-min पैरामीटर जोड़ें:

    GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00

    GET अनुरोध भेजने पर, सर्वर एचटीटीपी 200 OK स्टेटस कोड और एक फ़ीड दिखाता है. इस फ़ीड में, डोमेन के शेयर किए गए ऐसे संपर्क शामिल होते हैं जिन्हें तय की गई तारीख के बाद बनाया गया था या अपडेट किया गया था.

  2. फ़ीड एक बार में 10 एमबी से ज़्यादा डेटा नहीं दिखाता. तय की गई शर्तों के हिसाब से पूरी संपर्क सूची पाने के लिए, आगे बढ़ें लिंक पर बार-बार क्लिक करें. ऐसा तब तक करें, जब तक आपको रिटर्न फ़ीड में वह लिंक न दिखे.

इंक्रीमेंटल बदलावों को ट्रैक करना

डोमेन की शेयर की गई संपर्क सूची में होने वाले बदलावों को ट्रैक करने के लिए, ये करें: 1. फ़ीड का अनुरोध करते समय, फ़ीड के <updated> एलिमेंट की वैल्यू पर नज़र रखें. 1. क्वेरी पैरामीटर updated-min को <updated> वैल्यू पर सेट करके और showdeleted को true पर सेट करके, सिर्फ़ ऐसे डोमेन शेयर किए गए संपर्कों को पाया जा सकता है जो पिछले अनुरोध के बाद बदल गए हैं.

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

शेयर किया गया कोई एक संपर्क पाने के लिए, आपको उस संपर्क के लिंक का इस्तेमाल करना होगा. शेयर किए गए संपर्क का लिंक सिर्फ़ तब मिल सकता है, जब शेयर किए गए संपर्कों के फ़ीड में जाकर, उस संपर्क की एंट्री ढूंढी जाए. अगर आपको नहीं पता कि सेल्फ़ लिंक के लिए कौनसी वैल्यू का इस्तेमाल करना है, तो सभी संपर्कों को पाना और क्वेरी पैरामीटर का इस्तेमाल करके संपर्कों को पाना लेख पढ़ें.

  1. किसी खास डोमेन से शेयर किया गया संपर्क पाने के लिए, संपर्क के सेल्फ़ लिंक पर एचटीटीपी GET अनुरोध भेजें: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
     इनकी जगह ये डालें:
  • DOMAIN: आपके डोमेन का यूआरएल—उदाहरण के लिए, example.com.
  • PROJECTION: प्रोजेक्शन वैल्यू, जो gd:extendedProperty एलिमेंट के बारे में बताती है. इस्तेमाल की जा सकने वाली वैल्यू की सूची देखने के लिए, प्रक्षेपण वैल्यू देखें.
  • SELF_LINK: यह एक यूनीक संख्या होती है, जो शेयर किए गए किसी एक संपर्क को दिखाती है. उदाहरण के लिए, 12345.

इसके बाद, सर्वर एचटीटीपी 200 OK स्टेटस कोड और संपर्क की जानकारी वाली एंट्री दिखाता है.

उदाहरण के लिए, डोमेन का शेयर किया गया संपर्क पाने के लिए, जिसका सेल्फ़ लिंक https://www.google.com/m8/feeds/contacts/example.com/full/12345 पर सेट हो, यह एचटीटीपी अनुरोध भेजें:

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

अगले चरण