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

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

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

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