擴充屬性和投影

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

擴充屬性

您可以針對共用聯絡人項目，將其他共用聯絡人相關資訊設定為擴充屬性，以及任意名稱/值組合。您必須負責維護金鑰的不重複性。擴充屬性的值可儲存為值 (任意字串) 或 XML blob (純文字)。每個共用聯絡人最多可以有 10 個相關聯的延伸屬性。 每個擴充屬性都應合理小，請勿使用相片或環形。

注意： Google 聯絡人的共用聯絡人管理員不會顯示延伸屬性。

範例

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

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

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

<gd:extendedProperty name="com.google">
  &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 表示傳回的擴充屬性 (gd:extendedProperty 元素) 的金鑰 (適用於 GET 要求)，或應更新 (用於 PUT 或 POST 要求)。如果在更新作業期間未使用擴充屬性，系統就會刪除屬性。
full	系統會傳回所有 gd:extendedProperty 元素，而且更新期間必須納入所有元素。