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:
<gd:extendedProperty name="com.google" value="<var>VALUE</var>"/>
Aşağıdaki örnekte, anahtar ve XML blob'u içeren genişletilmiş bir özellik gösterilmektedir:
<gd:extendedProperty name="com.google">
<<var>XML_PARAMETER</var>></<var>XML_PARAMETER</var>>
</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. |