Projections et propriétés étendues

Pour définir des caractéristiques personnalisées pour un contact partagé, utilisez des propriétés et projections étendues.

Propriétés étendues

Vous pouvez définir d'autres informations relatives aux contacts partagés en tant que propriété étendue, avec des paires nom/valeur arbitraires, pour une entrée de contact partagé. Vous êtes tenu de préserver l'unicité des clés. La valeur d'une propriété étendue peut être stockée sous la forme d'une valeur (chaîne arbitraire) ou d'un blob XML (texte brut). Chaque contact partagé peut être associé à 10 propriétés étendues au maximum. Chaque propriété étendue doit être raisonnablement petite. N'utilisez pas de photo ni de sonnerie.

Exemple

L'exemple suivant montre une propriété étendue avec une clé et une valeur:

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

L'exemple suivant montre une propriété étendue avec une clé et 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>

Valeurs de projection

Pour limiter la visibilité étendue des propriétés, utilisez des projections. La définition de propriétés étendues (éléments gd:extendedElement) n'est autorisée que dans une projection full ou property-KEY.

Le tableau suivant décrit les valeurs de projection acceptées:

Nom de la projection Description
thin Aucun élément gd:extendedProperty n'est renvoyé ni mis à jour.
property-KEY KEY indique la clé d'une propriété étendue (élément gd:extendedProperty) qui est renvoyée (pour les requêtes GET) ou doit être mise à jour (pour une requête PUT ou POST). Si la propriété étendue n'est pas utilisée lors des opérations de mise à jour, elle est supprimée.
full Tous les éléments gd:extendedProperty sont renvoyés et tous les éléments doivent être inclus lors d'une mise à jour.