الحصول على جهات الاتصال المشتركة

يمكنك طلب جهات اتصال المستخدمين المشترَكة بالطرق التالية:

جميع جهات الاتصال المشتركة
مجموعة من جهات الاتصال التي تستوفي معايير محدّدة
جهة اتصال مشترَكة واحدة
صورة لجهة اتصال

تكون الإدخالات في الخلاصة غير مرتّبة تلقائيًا.

الحصول على جميع جهات الاتصال المشترَكة

للحصول على جميع جهات الاتصال المشتركة، أرسِل طلب HTTP GET إلى عنوان URL الخاص بخلاصة جهات الاتصال:

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

غيِّر القيم في السلسلة على الشكل التالي:

DOMAIN: نطاقك على سبيل المثال، example.com.
‫PROJECTION: قيمة العرض للاطّلاع على القيم المسموح بها، راجِع قيم العرض.

يعرض الخادم رمز الحالة 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>

تعرض الخلاصات 10 ميغابايت كحد أقصى في ردّ واحد. للحصول على القائمة الكاملة، اتّبِع بشكل متكرّر رابط التالي في الخلاصة التي تم إرجاعها.

الحصول على جهات الاتصال المشترَكة باستخدام مَعلمات طلب البحث

طلب جهات الاتصال التي تستوفي معايير محدّدة، مثل جهات الاتصال التي تم تعديلها بعد تاريخ معيّن لا تتوفّر طلبات البحث في النص الكامل وعمليات البحث عن عناوين البريد الإلكتروني. للاطّلاع على جميع مَعلمات طلب البحث، يُرجى الرجوع إلى دليل مرجع واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق".

أرسِل طلب HTTP GET إلى عنوان URL الخاص بخلاصة جهات الاتصال مع مَعلمة:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
غيِّر القيم في السلسلة على الشكل التالي:
- DOMAIN: نطاقك، مثل example.com.
- ‫PROJECTION: قيمة العرض للاطّلاع على القيم المسموح بها، راجِع قيم العرض.
- ‫PARAMETER: مَعلمة طلب بحث متوافقة اطّلِع على دليل مرجع واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق".
على سبيل المثال، للحصول على إدخالات تم تعديلها بعد 16 مارس 2022 للنطاق example.com، أضِف المَعلمة 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

الخطوات التالية

الحصول على صورة لجهة اتصال مشترَكة

الحصول على جهات الاتصال المشتركة تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.