لتحديد الخصائص المخصّصة لجهة اتصال مشتركة، استخدِم السمات الموسّعة. والتوقعات.
السمات الموسّعة
يمكنك تحديد معلومات إضافية ذات صلة بجهات الاتصال المشتركة كمعلومات إضافية مع أزواج عشوائية من الاسم والقيمة لإدخال جهة اتصال مشتركة. من المهم مسئوليتك في الحفاظ على التفرد الأساسي. يتم حساب قيمة يمكن تخزينها كقيمة (سلسلة عشوائية) أو كائن XML ثنائي الحجم (عادي). النص). يمكن ربط 10 خصائص موسعة كحد أقصى لكل جهة اتصال مشتركة. يجب أن تكون جميع المواقع الإلكترونية الموسّعة صغيرة إلى حد معقول. لا تستخدم صورة أو نغمة الرنين.
مثال
يوضّح المثال التالي سمة موسّعة تحتوي على مفتاح وقيمة:
<gd:extendedProperty name="com.google" value="<var>VALUE</var>"/>
يوضّح المثال التالي سمة موسّعة تحتوي على مفتاح وملف XML ثنائي كبير:
<gd:extendedProperty name="com.google">
<<var>XML_PARAMETER</var>></<var>XML_PARAMETER</var>>
</gd:extendedProperty>
قيم التوقع
للحد من إذن الوصول الموسَّع للموقع، استخدِم التوقعات. تم تمديد الإعداد
الخصائص (عناصر gd:extendedElement
) مسموح بها فقط في full
أو
توقع بنسبة property-KEY
.
يوضّح الجدول التالي قيم الإسقاط المتوافقة:
اسم التوقع | الوصف |
---|---|
thin |
ولن يتم عرض أي عناصر gd:extendedProperty أو
تحديث. |
property-KEY |
يشير KEY إلى مفتاح توسيع
(العنصر gd:extendedProperty ) الذي يتم عرضه
(لطلبات GET ) أو يجب تعديلها (للحصول على
PUT أو POST ). إذا تم تمديد
لا يُستخدم أثناء عمليات التحديث، فستُسمّى الخاصية
حذف. |
full
| يتم إرجاع جميع عناصر gd:extendedProperty
يجب تضمين جميع العناصر أثناء التحديث. |