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

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

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

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

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

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

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

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

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

1. إرسال طلب 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 وخلاصة تحتوي على أي جهات اتصال مشتركة في النطاق تم إنشاؤها أو تعديلها بعد التاريخ المحدّد.

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

تتبع التغييرات المتزايدة

لتتبع التغييرات التزايدية التي تطرأ على قائمة جهات الاتصال المشتركة في النطاق، يمكنك اتّباع الخطوات التالية: 1. عند إرسال طلب للحصول على خلاصة، تتبَّع قيمة عنصر <updated> في الخلاصة. 1- يمكنك الحصول فقط على جهات الاتصال المشتركة في النطاق التي تم تغييرها منذ الطلب السابق من خلال ضبط مَعلمة طلب البحث updated-min على قيمة <updated> تلك وضبط showdeleted على true.

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

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

1. للحصول على جهة اتصال مشتركة في نطاق محدّد، أرسِل طلب 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

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

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