تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

لا يتم ترتيب الإدخالات في الخلاصة تلقائيًا.

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

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

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

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

DOMAIN: عنوان URL لنطاقك، على سبيل المثال، 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>

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

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

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

أرسِل طلبًا إلى HTTP GET على عنوان URL لخلاصة جهات الاتصال باستخدام مَعلمة محدّدة:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
غيِّر القيم في السلسلة على الشكل التالي:
- DOMAIN: عنوان URL لنطاقك، على سبيل المثال، example.com
- ‫PROJECTION: قيمة الإسقاط التي تحدّد عناصر gd:extendedProperty للحصول على قائمة بالقيم المسموح بها، راجِع قيم الإسقاط.
- PARAMETER: إحدى مَعلمات طلب البحث المتوافقة لمزيد من المعلومات، يُرجى الاطّلاع على دليل مرجعي لواجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق".
على سبيل المثال، لتعديل جميع إدخالات جهات الاتصال المشتركة في النطاق بعد 16 آذار (مارس) 2022 في example.com، أرسِل طلب HTTP إلى عنوان URL لخلاصة جهات الاتصال المشترَكة في النطاق وأضِف المَعلمة updated-min إلى عنوان URL للطلب:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
عند إرسال طلب GET هذا، يعرض الخادم رمز حالة 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: عنوان URL لنطاقك، على سبيل المثال، example.com
PROJECTION: قيمة الإسقاط التي تحدّد عناصر gd:extendedProperty. للحصول على قائمة بالقيم المسموح بها، راجِع قيم الإسقاط.
SELF_LINK: قيمة رقمية فريدة تمثّل جهة اتصال مشترَكة واحدة، على سبيل المثال 12345.

يعرض الخادم بعد ذلك رمز حالة HTTP‏ 200 OK وإدخالًا يحتوي على جهة الاتصال.

على سبيل المثال، للحصول على جهة اتصال مشتركة في النطاق تم ضبط الرابط الذاتي لها على https://www.google.com/m8/feeds/contacts/example.com/full/12345، أرسِل طلب HTTP التالي:

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

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

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