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:
<gd:extendedProperty name="com.google" value="<var>VALUE</var>"/>
L'esempio seguente mostra una proprietà estesa con una chiave e un blob XML:
<gd:extendedProperty name="com.google">
<<var>XML_PARAMETER</var>></<var>XML_PARAMETER</var>>
</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. |