Proprietà e proiezioni estese

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

Proprietà estese

Puoi impostare informazioni aggiuntive relative ai contatti condivisi come informazioni per una voce di contatto condiviso, con coppie nome-valore arbitrarie. È la tua responsabilità di preservare l'univocità delle chiavi. Il valore di un'estensione può essere archiviata come valore (stringa arbitraria) o come blob XML testo). 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 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. Impostazione estesa proprietà (gd:extendedElement elementi) è consentita solo all'interno di un elemento full o proiezione property-KEY.

Nella tabella seguente sono descritti i valori di proiezione supportati:

Nome proiezione Descrizione
thin Non viene restituito alcun elemento gd:extendedProperty o aggiornato.
property-KEY KEY indica la chiave di un proprietà (elemento gd:extendedProperty) restituita (per richieste GET) o deve essere aggiornato (per un PUT o POST). Se l'estensione proprietà non viene utilizzata durante le operazioni di aggiornamento, viene eliminati.
full Vengono restituiti tutti gli elementi gd:extendedProperty durante un aggiornamento devono essere inclusi tutti gli elementi.