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

تستخدِم واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" عناصر 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"/>

في Domain Shared Contacts API، تكون عدة عناصر أكثر تقييدًا قليلاً من نوع جهة الاتصال. بالنسبة إلى العناصر التالية، يمكنك تقديم سمة 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 للمجموعات التي لم تعُد جهة الاتصال تنتمي إليها.