此页面由 Cloud Translation API 翻译。

扩展属性和投影

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

扩展属性

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