Properti dan proyeksi yang diperluas

Untuk menentukan karakteristik kustom bagi kontak bersama, gunakan properti dan proyeksi yang diperluas.

Properti yang diperluas

Anda dapat menetapkan informasi terkait kontak bersama tambahan sebagai properti yang diperluas, dengan pasangan nama-nilai arbitrer, untuk entri kontak bersama. Anda bertanggung jawab untuk mempertahankan keunikan kunci. Nilai properti yang diperluas dapat disimpan sebagai nilai (string arbitrer) atau blob XML (teks biasa). Setiap kontak bersama dapat memiliki maksimal 10 properti yang diperluas. Setiap properti yang diperluas harus cukup kecil; jangan gunakan foto atau ringtone.

Contoh

Contoh berikut menunjukkan properti yang diperluas dengan kunci dan nilai:

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

Contoh berikut menunjukkan properti yang diperluas dengan kunci dan blob XML:

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

Nilai proyeksi

Untuk membatasi visibilitas properti yang diperluas, gunakan proyeksi. Menetapkan properti ekstensi (elemen gd:extendedElement) hanya diizinkan dalam proyeksi full atau property-KEY.

Tabel berikut menjelaskan nilai proyeksi yang didukung:

Nama proyeksi Deskripsi
thin Tidak ada elemen gd:extendedProperty yang ditampilkan atau diperbarui.
property-KEY KEY menunjukkan kunci properti yang diperluas (elemen gd:extendedProperty) yang ditampilkan (untuk permintaan GET) atau harus diperbarui (untuk permintaan PUT atau POST). Jika properti yang diperluas tidak digunakan selama operasi pembaruan, properti tersebut akan dihapus.
full Semua elemen gd:extendedProperty ditampilkan dan semua elemen harus disertakan selama update.