擴充屬性和投影

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

擴充屬性

您可以將其他共用聯絡人相關資訊設為擴充屬性，並為共用聯絡人項目提供任意名稱/值配對。您有責任確保鍵的唯一性。擴充屬性的值可以儲存為值 (任意字串) 或 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>

預測值

如要限制擴充屬性的顯示範圍，請使用投影。設定擴充屬性 (gd:extendedElement 元素) 時，只能在 full 或 property-KEY 投影中進行。

下表說明支援的投影值：

預測名稱 說明
thin 不會傳回或更新任何 gd:extendedProperty 元素。
property-KEY KEY 表示傳回 (適用於 GET 要求) 或應更新 (適用於 PUT 或 POST 要求) 的擴充屬性 (gd:extendedProperty 元素) 金鑰。如果在更新作業期間未使用擴充屬性，系統會刪除該屬性。
full 系統會傳回所有 gd:extendedProperty 元素，且更新時必須納入所有元素。