Genişletilmiş özellikler ve tahminler

Paylaşılan bir kişi için özel özellikleri tanımlamak üzere genişletilmiş özellikleri ve projeksiyonları kullanın.

Genişletilmiş mülkler

Paylaşılan bir kişi girişi için, paylaşılan kişiyle ilgili ek bilgileri, ad-değer çiftleriyle birlikte genişletilmiş mülk olarak ayarlayabilirsiniz. Anahtarın benzersizliğini korumak sizin sorumluluğunuzdadır. Genişletilmiş bir mülkün değeri, değer (rastgele dize) veya XML blob'u (düz metin) olarak depolanabilir. Her paylaşılan kişide en fazla 10 genişletilmiş mülk ilişkilendirilebilir. Her ek mülk makul ölçüde küçük olmalıdır. Fotoğraf veya zil sesi kullanmayın.

Örnek

Aşağıdaki örnekte, bir anahtar ve değer içeren genişletilmiş bir mülk gösterilmektedir:

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

Aşağıdaki örnekte, anahtar ve XML blob'u içeren genişletilmiş bir mülk gösterilmektedir:

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

Projeksiyon değerleri

Genişletilmiş mülk görünürlüğünü sınırlamak için projeksiyonları kullanın. Genişletilmiş mülkleri (gd:extendedElement öğeleri) ayarlamaya yalnızca full veya property-KEY projeksiyonunda izin verilir.

Aşağıdaki tabloda desteklenen projeksiyon değerleri açıklanmaktadır:

Projeksiyon adı Açıklama
thin Hiçbir gd:extendedProperty öğesi döndürülmez veya güncellenmez.
property-KEY KEY, döndürülen (GET istekleri için) veya güncellenmesi gereken (PUT veya POST isteği için) genişletilmiş bir mülkün (gd:extendedProperty öğesi) anahtarını belirtir. Genişletilmiş özellik güncelleme işlemleri sırasında kullanılmazsa silinir.
full Tüm gd:extendedProperty öğeleri döndürülür ve güncelleme sırasında tüm öğelerin eklenmesi gerekir.