扩展属性和投影

如需为共享联系人定义自定义特征，请使用扩展属性和投影。

扩展属性

您可以为共享联系人条目设置其他共享联系人相关信息作为扩展属性，其中包含任意名称-值对。您有责任确保键的唯一性。扩展属性的值可以存储为值（任意字符串）或 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 元素，并且在更新期间必须包含所有元素。