تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

جميع جهات الاتصال المشترَكة
مجموعة من جهات الاتصال التي تطابِق معايير محدّدة
جهة اتصال مشترَكة واحدة
صورة لجهة اتصال

تظهر الإدخالات في الخلاصة بدون ترتيب تلقائيًا.

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

للحصول على جميع جهات الاتصال المشترَكة، أرسِل طلب 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

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

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

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