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

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

शेयर किए गए सभी संपर्क
तय की गई शर्तों को पूरा करने वाले संपर्कों का सेट
शेयर किया गया एक संपर्क
किसी संपर्क के लिए फ़ोटो

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

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

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

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

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

DOMAIN: आपका डोमेन. उदाहरण के लिए, example.com.
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>

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

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

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

पैरामीटर के साथ, संपर्कों के फ़ीड के यूआरएल पर HTTP GET अनुरोध भेजें:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
इनकी जगह ये डालें:
- DOMAIN: आपका डोमेन—उदाहरण के लिए, example.com.
- PROJECTION: प्रोजेक्शन वैल्यू. इस्तेमाल की जा सकने वाली वैल्यू के लिए, प्रोजेक्शन वैल्यू देखें.
- 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
```
सर्वर, HTTP 200 OK स्टेटस कोड और मिलते-जुलते ऑफ़र वाला फ़ीड दिखाता है.
फ़ीड, एक जवाब में ज़्यादा से ज़्यादा 10 एमबी का डेटा दिखाता है. पूरी सूची पाने के लिए, नतीजे के तौर पर मिले फ़ीड में मौजूद अगला लिंक पर बार-बार क्लिक करें.

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

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

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

किसी संपर्क की जानकारी पाने के लिए, संपर्क के सेल्फ लिंक का इस्तेमाल करें. यह लिंक, शेयर किए गए संपर्कों के फ़ीड में मिल सकता है. ज़्यादा जानकारी के लिए, शेयर किए गए सभी संपर्क पाना लेख पढ़ें.

किसी संपर्क की जानकारी पाने के लिए, उसके सेल्फ़ लिंक पर HTTP GET अनुरोध भेजें:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
```
इनकी जगह ये डालें:

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

सर्वर, HTTP 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

अगले चरण

शेयर किए गए किसी संपर्क की फ़ोटो पाना