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

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

إلى جانب المواقع العادية قيم مثل "ذات" أو "تعديل"، يمكنك استخدام 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 المجموعات التي لا تنتمي إليها جهة الاتصال بعد الآن.