Proyecciones y propiedades extendidas

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:

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

En el siguiente ejemplo, se muestra una propiedad extendida con clave y un BLOB XML:

&lt;gd:extendedProperty name="com.google"&gt;
  &lt;<var>XML_PARAMETER</var>&gt;&lt;/<var>XML_PARAMETER</var>&gt;
&lt;/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.