Genişletilmiş özellikler ve tahminler

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

Genişletilmiş özellikler

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

Örnek

Aşağıdaki örnekte, anahtarı ve değeri olan genişletilmiş bir özellik gösterilmektedir:

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

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

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

Tahmin değerleri

Genişletilmiş özellik görünürlüğünü sınırlamak için projeksiyonları kullanın. Genişletilmiş özelliklerin (gd:extendedElement öğeleri) ayarlanmasına 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 gd:extendedProperty öğeleri döndürülmez veya güncellenmez.
property-KEY KEY, döndürülen (GET istekleri için) veya güncellenmesi gereken (PUT ya da POST isteği için) genişletilmiş bir özelliğin (gd:extendedProperty öğesi) anahtarını gösterir. Genişletilmiş özellik güncelleme işlemleri sırasında kullanılmazsa özellik silinir.
full Tüm gd:extendedProperty öğeleri döndürülür ve güncelleme sırasında tüm öğeler eklenmelidir.