Properti dan proyeksi yang diperluas

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

Properti yang diperluas

Anda dapat menetapkan informasi tambahan terkait kontak bersama sebagai properti yang diperluas, dengan pasangan nama-nilai arbitrer, untuk entri kontak bersama. Anda bertanggung jawab untuk menjaga 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 tambahan yang dikaitkan. Setiap properti yang diperluas harus berukuran cukup kecil; jangan gunakan foto atau nada dering.

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 yang diperluas (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 update, properti tersebut akan dihapus.
full Semua elemen gd:extendedProperty ditampilkan dan semua elemen harus disertakan selama update.