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

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

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

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