Projections et propriétés étendues

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

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ée. Il est de votre responsabilité de préserver l'unicité des clés. La valeur d'une propriété étendue peut être stockée sous forme de valeur (chaîne arbitraire) ou de 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é des propriétés étendues, utilisez des projections. Le paramétrage de propriétés étendues (éléments gd:extendedElement) n'est autorisé 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) renvoyée (pour les requêtes GET) ou à mettre à 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.