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

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

พร็อพเพอร์ตี้เพิ่มเติม

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

ตัวอย่าง

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

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

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

&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 ทั้งหมดและจะต้องรวมองค์ประกอบทั้งหมดไว้ในการอัปเดต