คุณสมบัติและการฉายภาพแบบขยาย

หากต้องการกำหนดคุณลักษณะที่กำหนดเองของรายชื่อติดต่อที่แชร์ ให้ใช้คุณสมบัติและการคาดการณ์แบบขยาย

พร็อพเพอร์ตี้แบบขยาย

คุณสามารถตั้งค่าข้อมูลที่เกี่ยวข้องกับรายชื่อติดต่อที่แชร์เพิ่มเติมเป็นพร็อพเพอร์ตี้เพิ่มเติม โดยใช้คู่ชื่อ-ค่าที่กำหนดเองสำหรับรายการรายชื่อติดต่อที่แชร์ คุณต้องรับผิดชอบในการรักษาความเฉพาะตัวที่สำคัญ ค่าของพร็อพเพอร์ตี้แบบขยายสามารถจัดเก็บเป็นค่า (สตริงที่กำหนดเอง) หรือ XML Blob (ข้อความธรรมดา) ก็ได้ รายชื่อติดต่อที่แชร์แต่ละรายการสามารถเชื่อมโยงกับพร็อพเพอร์ตี้ที่ขยายได้สูงสุด 10 รายการ พร็อพเพอร์ตี้ที่ขยายแต่ละรายการควรมีขนาดเล็กพอสมควร อย่าใช้รูปภาพหรือเสียงเรียกเข้า

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงพร็อพเพอร์ตี้แบบขยายที่มีคีย์และค่า

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

ตัวอย่างต่อไปนี้แสดงพร็อพเพอร์ตี้แบบขยายที่มีคีย์และ XML Blob

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

ค่าเส้นโครง

หากต้องการจำกัดระดับการเข้าถึงพร็อพเพอร์ตี้เพิ่มเติม ให้ใช้การคาดการณ์ การตั้งค่าพร็อพเพอร์ตี้เพิ่มเติม (องค์ประกอบ gd:extendedElement) ได้รับอนุญาตภายในการคาดการณ์ full หรือ property-KEY เท่านั้น

ตารางต่อไปนี้อธิบายค่าการฉายภาพที่รองรับ

ชื่อการคาดการณ์ คำอธิบาย
thin จะไม่มีการอัปเดตหรืออัปเดตเอลิเมนต์ gd:extendedProperty
property-KEY KEY บ่งชี้คีย์ของพร็อพเพอร์ตี้เพิ่มเติม (องค์ประกอบ gd:extendedProperty) ที่ส่งคืน (สำหรับคำขอ GET) หรือควรอัปเดต (สำหรับคำขอ PUT หรือ POST) หากไม่ได้ใช้พร็อพเพอร์ตี้ที่ขยายในระหว่างการอัปเดต ระบบจะลบพร็อพเพอร์ตี้ออก
full ระบบจะแสดงผลเอลิเมนต์ gd:extendedProperty ทั้งหมดและ ต้องรวมเอลิเมนต์ทั้งหมดในระหว่างการอัปเดต