عناصر جهات الاتصال المشتركة

تستخدم واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" عناصر Google Data API العادية والعناصر الخاصة بجهات الاتصال المشتركة.

يتخذ إدخال جهة الاتصال شكل نوع جهة الاتصال الموسّع، الذي يمثّل شخصًا أو مكانًا، مثل نادٍ أو مطعم، أو مؤسسة. يظهر نوع جهة الاتصال في XML كعنصر <atom:entry> يحتوي على عناصر توسيع مختلفة من مساحة اسم Google Data.

يبدو عنصر category الذي يشير إلى أنّ الإدخال هو جهة اتصال على النحو التالي:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

في واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق"، تكون بعض العناصر أكثر تقييدًا من نوع جهة الاتصال. بالنسبة إلى العناصر التالية، يمكنك تقديم إما السمة rel أو السمة label، ولكن ليس كلتيهما:

• gd:email
• gd:im
• gd:organization
• gd:phoneNumber
• gd:structuredPostalAddress

عند إنشاء جهة اتصال مشترَكة أو تعديلها، إذا قدّمت كلاً من rel وlabel أو لم تقدّم أيًا منهما لأي من هذه العناصر، سيرفض الخادم الإدخال.

دعم "صور Google"

بالإضافة إلى قيم الخصائص العادية، مثل self أو edit، يمكنك استخدام قيم rel لعناصر atom:link. عند استخدام روابط الصور، يجب تحديد رمز التفويض في عنوان HTTP. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على المصادقة والتفويض.

• باستخدام أمر GET، يضيف rel="http://schemas.google.com/contacts/2008/rel#photo" إمكانية قراءة الصورة المرتبطة بجهة الاتصال. يمكنك استخدام عنوان URL المحدّد في href لقراءة أحدث إصدار من الصورة المرتبطة بجهة الاتصال. لن يظهر الرابط إذا لم تكن هناك صورة لجهة الاتصال.

مثال:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />

• باستخدام الأمر PUT أو DELETE، يضيف rel="http://schemas.google.com/contacts/2008/rel#edit-photo" إمكانية تعديل صورة محلية مرتبطة بجهة الاتصال أو حذفها.

مثال:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

gContact مساحة الاسم

عنوان URL لمساحة اسم XML الخاصة بـ gContact هو http://schemas.google.com/contact/2008.

في مساحة الاسم هذه، يتم تحديد عنصر يمثّل مجموعة ينتمي إليها جهة الاتصال.

gContact:groupMembershipInfo مكانًا للإقامة

الموقع	الوصف
href	تحدّد هذه السمة المجموعة التي تنتمي إليها جهة الاتصال أو كانت تنتمي إليها. يتم الرجوع إلى المجموعة من خلال رقم تعريفها.
deleted="true"	يشير ذلك إلى أنّه تمت إزالة عضوية جهة الاتصال في المجموعة. لا يتم تضمين هذه السمة إلا إذا تم تحديد showdeleted كمعلَمة طلب بحث، وإلا لن يتم عرض groupMembershipInfo للمجموعات التي لم يعُد جهة الاتصال عضوًا فيها.