المواقع الموسعة والتوقعات

لتحديد الخصائص المخصصة لجهة اتصال مشتركة، استخدم الخصائص والتوقعات الموسعة.

الخصائص الموسّعة

يمكنك ضبط معلومات إضافية مشتركة ذات صلة بجهات الاتصال كموقع موسّع، مع أزواج عشوائية من الاسم-القيمة، لإدخال جهة اتصال مشتركة. تقع على عاتقك مسئولية الحفاظ على التفرد الرئيسي. يمكن تخزين قيمة الخاصية الموسّعة كقيمة (سلسلة عشوائية) أو كرمز XML ثنائي كبير (نص عادي). يمكن أن تشتمل كل جهة اتصال مشتركة على 10 مواقع موسّعة مرتبطة على الأكثر. ويجب أن يكون كل موقع من المواقع الموسّعة صغيرًا بشكل معقول، لذا لا تستخدم صورة أو نغمة رنين.

مثال

يوضّح المثال التالي سمة موسّعة مع مفتاح وقيمة:

&lt;gd:extendedProperty name="com.google" value="<var>VALUE</var>"/&gt;

يعرض المثال التالي سمة موسّعة مع مفتاح وكائن XML ثنائي كبير:

&lt;gd:extendedProperty name="com.google"&gt;
  &lt;<var>XML_PARAMETER</var>&gt;&lt;/<var>XML_PARAMETER</var>&gt;
&lt;/gd:extendedProperty>

قيم التوقع

ولالحدّ من إذن الوصول الموسّع إلى الموقع الإلكتروني، استخدِم التوقعات. يُسمح بإعداد الخصائص الموسّعة (عناصر gd:extendedElement) فقط ضمن إسقاط full أو property-KEY.

يصف الجدول التالي قيم التوقع المتوافقة:

اسم العرض الوصف
thin لا يتم إرجاع أي عناصر gd:extendedProperty أو تحديثها.
property-KEY تشير السمة KEY إلى مفتاح السمة الموسّعة (العنصر gd:extendedProperty) التي يتم عرضها (لطلبات GET) أو التي يجب تعديلها (لطلب PUT أو POST). إذا لم يتم استخدام الخاصية الموسّعة أثناء عمليات التعديل، سيتم حذفها.
full يتم إرجاع جميع عناصر gd:extendedProperty ويجب تضمين جميع العناصر أثناء التحديث.