נכסים מורחבים ותחזיות

כדי להגדיר מאפיינים מותאמים אישית לאיש קשר משותף, משתמשים במאפיינים מורחבים ובהקרנות.

מאפיינים מורחבים

אפשר להגדיר מידע נוסף שקשור לאיש קשר משותף כמאפיין מורחב, עם צמדים שרירותיים של שם-ערך, עבור רשומה של איש קשר משותף. באחריותכם לשמור על הייחודיות של המפתחות. אפשר לשמור את הערך של מאפיין מורחב כערך (מחרוזת שרירותית) או כ-blob של XML (טקסט פשוט). לכל איש קשר משותף יכולים להיות לכל היותר 10 מאפיינים מורחבים משויכים. כל מאפיין מורחב צריך להיות קטן יחסית. אל תשתמשו בתמונה או ברינגטון.

דוגמה

בדוגמה הבאה מוצג מאפיין מורחב עם מפתח וערך:

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

בדוגמה הבאה מוצג נכס מורחב עם מפתח ו-blob של 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 מוחזרים וצריך לכלול את כל הרכיבים במהלך עדכון.