Proprietà e proiezioni estese

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

Proprietà estese

Puoi impostare ulteriori informazioni relative al contatto condiviso come proprietà estesa, con coppie nome-valore arbitrarie, per una voce di contatto condiviso. È tua responsabilità preservare l'unicità della chiave. Il valore di una proprietà estesa può essere archiviato come valore (stringa arbitraria) o blob XML (testo normale). A ogni contatto condiviso possono essere associate al massimo 10 proprietà estese. Ogni proprietà estesa deve essere ragionevolmente piccola; non utilizzare una foto o una 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 una 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à estesa della proprietà, utilizza le proiezioni. L'impostazione di proprietà estese (gd:extendedElement elementi) è consentita solo all'interno di una proiezione full o property-KEY.

La tabella seguente descrive i valori di proiezione supportati:

Nome proiezione Descrizione
thin Nessun elemento gd:extendedProperty viene restituito o aggiornato.
property-KEY KEY indica la chiave di una proprietà estesa (elemento gd:extendedProperty) che viene restituita (per le richieste GET) o che deve essere aggiornata (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.