Projections et propriétés étendues

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

Propriétés étendues

Vous pouvez définir des informations supplémentaires sur les contacts partagés en tant que propriété étendue, avec des paires nom/valeur arbitraires, pour une entrée de contact partagé. Vous êtes responsable de la préservation de l'unicité des clés. La valeur d'une propriété étendue peut être stockée en tant que valeur (chaîne arbitraire) ou blob XML (texte brut). Chaque contact partagé peut être associé à un maximum de 10 propriétés étendues. 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é des propriétés étendues, utilisez des projections. La définition de propriétés étendues (gd:extendedElement éléments) n'est autorisée que dans une full ou property-KEY projection.

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.