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

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

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

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

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

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

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

    नीचे दी गई चीज़ों को बदलें:

    यह फ़ीड, HTTP 200 OK स्टेटस कोड और संपर्कों वाला स्टैंडर्ड ऐटम 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

    नीचे दी गई चीज़ों को बदलें:

    उदाहरण के लिए, 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

अगले चरण