此页面由 Cloud Translation API 翻译。

扩展属性和投影

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

扩展属性

您可以为共享联系人条目将其他共享联系人相关信息设置为扩展属性，并使用任意名称-值对。您有责任确保密钥的唯一性。扩展属性的值可以存储为值（任意字符串）或 XML BLOB（纯文本）。每个共享联系人最多可以关联 10 个扩展属性。每个扩展属性都应尽可能小；请勿使用照片或铃声。

以下示例展示了一个包含键和值的扩展属性：

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

以下示例展示了一个包含键和 XML 字节数组的扩展属性：

&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` 元素，并且在更新期间必须包含所有元素。