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 compartido. Es tu responsabilidad preservar la unicidad de la clave. El valor de una propiedad extendida se puede almacenar como un valor (cadena arbitraria) o un objeto binario grande XML (texto sin formato). Cada contacto compartido puede tener asociadas como máximo 10 propiedades extendidas. 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 binario grande 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 (gd:extendedElement elementos) solo se permite dentro de una full o property-KEY proyección.

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

Nombre de la proyección Descripción
thin No se muestran ni se 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 la propiedad extendida no se usa durante las operaciones de actualización, se borra.
full Se muestran todos los elementos gd:extendedProperty, y todos los elementos deben incluirse durante una actualización.