Genişletilmiş özellikler ve tahminler

Ortak bir kişinin özel niteliklerini tanımlamak için genişletilmiş özellikleri ve projeksiyonları kullanın.

Genişletilmiş özellikler

Paylaşılan kişi girişi için rastgele ad-değer çiftleriyle genişletilmiş özellik olarak ek paylaşılan kişi bilgileri ayarlayabilirsiniz. Anahtarın benzersizliğini korumak sizin sorumluluğunuzdadır. Genişletilmiş bir özelliğin değeri, değer (isteğe bağlı dize) veya XML blobu (düz metin) olarak depolanabilir. Paylaşılan her kişinin en fazla 10 genişletilmiş mülkü olabilir. Genişletilmiş mülklerin her biri makul ölçüde küçük olmalıdır; fotoğraf veya zil sesi kullanmayın.

Örnek

Aşağıdaki örnekte, bir anahtar ve bir değere sahip 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 ö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>

Projeksiyon değerleri

Genişletilmiş mülk 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 projeksiyonu içinde 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 özelliğin (gd:extendedProperty öğesi) anahtarını belirtir. Genişletilmiş mülk güncelleme işlemleri sırasında kullanılmazsa mülk silinir.
full Tüm gd:extendedProperty öğeleri döndürülür ve güncelleme sırasında tüm öğelerin dahil edilmesi gerekir.