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

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

Thuộc tính mở rộng

Bạn có thể đặt thông tin bổ sung liên quan đến người liên hệ dùng chung 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ục nhập thông tin liên hệ dùng chung. 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 một giá trị (chuỗi tuỳ ý) hoặc một blob XML (văn bản thuần tuý). Mỗi người liên hệ được chia sẻ có thể liên kết với tối đa 10 tài sản mở rộng. Mỗi thuộc tính mở rộng phải có kích thước nhỏ hợp lý; đừ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 với một khoá và một 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 với 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ị phép chiếu

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

Bảng sau đây mô tả các giá trị phép 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 (phần tử gd:extendedProperty) được trả về (đối với 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 dùng trong các hoạt động cập nhật, thì thuộc tính sẽ bị xoá.
full Mọi phần tử gd:extendedProperty đều được trả về và mọi phần tử phải được đưa vào trong quá trình cập nhật.