Thuộc tính và phép chiếu mở rộng

Để xác định các đặc điểm tuỳ chỉnh cho một người liên hệ được chia sẻ, hãy sử dụng các thuộc tính mở rộng và phép chiếu.

Thuộc tính mở rộng

Bạn có thể đặt thêm thông tin liên quan đến người liên hệ được chia sẻ dưới dạng một thuộc tính mở rộng, với các cặp tên-giá trị tuỳ ý, cho một mục người liên hệ được chia sẻ. Bạn có trách nhiệm duy trì tính duy nhất của khoá. Giá trị của một thuộc tính mở rộng có thể được lưu trữ dưới dạng giá trị (chuỗi tuỳ ý) hoặc một tệp XML lớn (văn bản thuần tuý). Mỗi người liên hệ dùng chung có thể có tối đa 10 thuộc tính mở rộng được liên kết. Mỗi thuộc tính mở rộng phải có kích thước nhỏ hợp lý; không sử dụng ảnh hoặc nhạc chuông.

Ví dụ:

Ví dụ sau đây cho thấy một thuộc tính mở rộng có khoá và giá trị:

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

Ví dụ sau đây cho thấy một thuộc tính mở rộng có khoá và một blob XML:

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

Giá trị chiếu

Để giới hạn chế độ hiển thị thuộc tính mở rộng, hãy sử dụng phép chiếu. Bạn chỉ được phép đặt các thuộc tính mở rộng (phần tử gd:extendedElement) trong một phép chiếu full hoặc property-KEY.

Bảng sau đây mô tả các giá trị chiếu được hỗ trợ:

Tên phép chiếu Mô tả
thin Không có phần tử gd:extendedProperty nào được trả về hoặc cập nhật.
property-KEY KEY cho biết khoá của một thuộc tính mở rộng (thành phần gd:extendedProperty) được trả về (đối với các yêu cầu GET) hoặc cần được cập nhật (đối với yêu cầu PUT hoặc POST). Nếu thuộc tính mở rộng không được sử dụng trong các thao tác cập nhật, thì thuộc tính đó sẽ bị xoá.
full Tất cả phần tử gd:extendedProperty đều được trả về và tất cả phần tử đều phải được đưa vào trong quá trình cập nhật.