عناصر مخاطبین مشترک

Domain Shared Contacts API از عناصر استاندارد 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 یا هیچکدام از آن عناصر را تهیه کنید، سرور ورودی را رد می‌کند.

پشتیبانی از عکس ها

همراه با مقادیر ویژگی های استاندارد مانند 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 namespace

URL فضای نام XML برای gContact http://schemas.google.com/contact/2008 است.

در این فضای نام، عنصری تعریف شده است که نشان دهنده گروهی است که مخاطب به آن تعلق دارد.

ویژگی های gContact:groupMembershipInfo

ویژگی شرح
href گروهی را که مخاطب به آن تعلق دارد یا به آن تعلق دارد را مشخص می کند. این گروه با شناسه خود ارجاع داده می شود.
deleted="true" به این معنی که عضویت گروه برای مخاطب حذف شده است. این ویژگی تنها در صورتی گنجانده می‌شود که showdeleted به عنوان پارامتر پرس و جو مشخص شده باشد، در غیر این صورت groupMembershipInfo برای گروه‌هایی که مخاطبی دیگر به آن تعلق ندارد، برگردانده نمی‌شود.