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:
<gd:extendedProperty name="com.google" value="<var>VALUE</var>"/>
Contoh berikut menunjukkan properti yang diperluas dengan kunci dan blob XML:
<gd:extendedProperty name="com.google">
<<var>XML_PARAMETER</var>></<var>XML_PARAMETER</var>>
</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. |