Proprietà e proiezioni estese

Per definire caratteristiche personalizzate per un contatto condiviso, utilizza proprietà e proiezioni estese.

Proprietà estese

Puoi impostare ulteriori informazioni relative ai contatti condivisi come proprietà estesa, con coppie nome-valore arbitrarie, per una voce del contatto condiviso. È colpa tua se la chiave non è univoca. Il valore di una proprietà estesa può essere archiviato come valore (stringa arbitraria) o come blob XML (testo semplice). A ogni contatto condiviso possono essere associate al massimo 10 proprietà estese. Ogni proprietà estesa deve essere ragionevolmente piccola. Non utilizzare una foto o un suoneria.

Esempio

L'esempio seguente mostra una proprietà estesa con una chiave e un valore:

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

L'esempio seguente mostra una proprietà estesa con chiave e 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>

Valori di proiezione

Per limitare la visibilità delle proprietà estese, utilizza le proiezioni. L'impostazione di proprietà estese (elementi gd:extendedElement) è consentita solo all'interno di una proiezione full o property-KEY.

La tabella seguente descrive i valori di proiezione supportati:

Nome della proiezione Descrizione
thin Nessun elemento gd:extendedProperty viene restituito o aggiornato.
property-KEY KEY indica la chiave di una proprietà estesa (elemento gd:extendedProperty) restituita (per le richieste GET) o da aggiornare (per una richiesta PUT o POST). Se la proprietà estesa non viene utilizzata durante le operazioni di aggiornamento, viene eliminata.
full Tutti gli elementi gd:extendedProperty vengono restituiti e tutti gli elementi devono essere inclusi durante un aggiornamento.