扩展属性和投影

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

扩展属性

您可以将其他共享联系人相关信息设置为 属性（具有任意名称-值对）。时间是 您都有责任保持密钥的唯一性。扩展 属性可存储为值（任意字符串）或 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 表示扩展的键 属性（gd:extendedProperty 元素） （针对 GET 请求）或者应更新（针对 PUT 或 POST 请求）。如果扩展的 属性在更新操作期间未使用，则该属性是 已删除。
full 系统会返回所有 gd:extendedProperty 元素， 所有元素都必须包含在更新期间