Para definir las características personalizadas de un contacto compartido, usa proyecciones y propiedades extendidas.
Propiedades extendidas
Puedes establecer información adicional relacionada con los contactos compartidos como una propiedad extendida, con pares nombre-valor arbitrarios para una entrada de contacto compartida. Es tu responsabilidad preservar la unicidad clave. El valor de una propiedad extendida se puede almacenar como un valor (string arbitraria) o un BLOB XML (texto sin formato). Cada contacto compartido puede tener como máximo 10 propiedades extendidas asociadas. Cada propiedad extendida debe ser razonablemente pequeña; no uses una foto ni un tono de llamada.
Ejemplo
En el siguiente ejemplo, se muestra una propiedad extendida con una clave y un valor:
<gd:extendedProperty name="com.google" value="<var>VALUE</var>"/>
En el siguiente ejemplo, se muestra una propiedad extendida con clave y un BLOB XML:
<gd:extendedProperty name="com.google">
<<var>XML_PARAMETER</var>></<var>XML_PARAMETER</var>>
</gd:extendedProperty>
Valores de proyección
Para limitar la visibilidad extendida de las propiedades, usa proyecciones. Solo se permite configurar propiedades extendidas (elementos gd:extendedElement
) dentro de una proyección full
o property-KEY
.
En la siguiente tabla, se describen los valores de proyección compatibles:
Nombre de la proyección | Descripción |
---|---|
thin |
No se muestran ni actualizan elementos gd:extendedProperty . |
property-KEY |
KEY indica la clave de una propiedad extendida (elemento gd:extendedProperty ) que se muestra (para solicitudes GET ) o que debe actualizarse (para una solicitud PUT o POST ). Si la propiedad extendida no se usa durante las operaciones de actualización, la propiedad se borrará. |
full
| Se muestran todos los elementos gd:extendedProperty , que deben incluirse durante una actualización. |