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

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