擴充屬性和投影

如要為共用聯絡人定義自訂特徵，請使用擴充屬性和投影。

延伸屬性

您可以將其他共用聯絡人相關資訊設為擴充屬性，並為共用聯絡人項目提供任意名稱/值組合。您有責任確保鍵的唯一性。擴充屬性的值可儲存為值 (任意字串) 或 XML blob (純文字)。每個共用聯絡人最多可連結 10 個擴充屬性。每個擴充屬性都應盡量小，請勿使用相片或鈴聲。

範例

以下範例顯示含有索引鍵和值的擴充屬性：

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

以下範例顯示含有鍵和 XML blob 的擴充屬性：

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

投影值

如要限制擴充屬性的瀏覽權限，請使用投影功能。您只能在 full 或 property-KEY 投影中設定擴充屬性 (gd:extendedElement 元素)。

下表說明支援的投影值：

投影名稱 說明
thin 不會傳回或更新任何 gd:extendedProperty 元素。
property-KEY KEY 會指出要傳回 (針對 GET 要求) 或應更新 (針對 PUT 或 POST 要求) 的擴充屬性 (gd:extendedProperty 元素) 鍵。如果在更新作業期間未使用擴充屬性，系統會刪除該屬性。
full 系統會傳回所有 gd:extendedProperty 元素，且所有元素都必須在更新期間納入。