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

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

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

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