Proyecciones y propiedades extendidas

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

Propiedades extendidas

Puedes establecer información adicional relacionada con los contactos compartidos como una extensión con pares de nombre y valor arbitrarios para una entrada de contacto compartida. Es tu responsabilidad de preservar la unicidad de la clave. El valor de una extensión La propiedad se puede almacenar como un valor (cadena arbitraria) o un BLOB XML (sin formato). texto). 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 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. Se extendió el parámetro de configuración propiedades (gd:extendedElement elementos) solo se permiten en una 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 elementos gd:extendedProperty o se actualicen.
property-KEY KEY indica la clave de una función propiedad (elemento gd:extendedProperty) que se muestra (para solicitudes GET) o debe actualizarse (para un PUT o POST). Si la extensión no se usa durante las operaciones de actualización, se borrar.
full Se muestran todos los elementos gd:extendedProperty y se deben incluir todos los elementos durante una actualización.