Proyecciones y propiedades extendidas

Para definir características personalizadas para un contacto compartido, usa propiedades y proyecciones extendidas.

Propiedades extendidas

Puedes establecer información adicional relacionada con el contacto compartido como una propiedad extendida, con pares nombre-valor arbitrarios, para una entrada de contacto compartida. Es tu responsabilidad preservar la unicidad de las claves. El valor de una propiedad extendida se puede almacenar como un valor (cadena 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 una clave y un objeto 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 de las propiedades extendidas, usa proyecciones. La configuración de propiedades extendidas (elementos gd:extendedElement) solo se permite dentro de una proyección full o property-KEY.

En la siguiente tabla, se describen los valores de proyección admitidos:

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 se debe actualizar (para una solicitud PUT o POST). Si no se usa la propiedad extendida durante las operaciones de actualización, esta se borra.
full Se muestran todos los elementos gd:extendedProperty y se deben incluir todos los elementos durante una actualización.