หากต้องการกำหนดคุณลักษณะที่กำหนดเองของรายชื่อติดต่อที่แชร์ ให้ใช้คุณสมบัติและการคาดการณ์แบบขยาย
พร็อพเพอร์ตี้แบบขยาย
คุณสามารถตั้งค่าข้อมูลที่เกี่ยวข้องกับรายชื่อติดต่อที่แชร์เพิ่มเติมเป็นพร็อพเพอร์ตี้เพิ่มเติม โดยใช้คู่ชื่อ-ค่าที่กำหนดเองสำหรับรายการรายชื่อติดต่อที่แชร์ คุณต้องรับผิดชอบในการรักษาความเฉพาะตัวที่สำคัญ ค่าของพร็อพเพอร์ตี้แบบขยายสามารถจัดเก็บเป็นค่า (สตริงที่กำหนดเอง) หรือ XML Blob (ข้อความธรรมดา) ก็ได้ รายชื่อติดต่อที่แชร์แต่ละรายการสามารถเชื่อมโยงกับพร็อพเพอร์ตี้ที่ขยายได้สูงสุด 10 รายการ พร็อพเพอร์ตี้ที่ขยายแต่ละรายการควรมีขนาดเล็กพอสมควร อย่าใช้รูปภาพหรือเสียงเรียกเข้า
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงพร็อพเพอร์ตี้แบบขยายที่มีคีย์และค่า
<gd:extendedProperty name="com.google" value="<var>VALUE</var>"/>
ตัวอย่างต่อไปนี้แสดงพร็อพเพอร์ตี้แบบขยายที่มีคีย์และ XML Blob
<gd:extendedProperty name="com.google">
<<var>XML_PARAMETER</var>></<var>XML_PARAMETER</var>>
</gd:extendedProperty>
ค่าเส้นโครง
หากต้องการจำกัดระดับการเข้าถึงพร็อพเพอร์ตี้เพิ่มเติม ให้ใช้การคาดการณ์ การตั้งค่าพร็อพเพอร์ตี้เพิ่มเติม (องค์ประกอบ gd:extendedElement
) ได้รับอนุญาตภายในการคาดการณ์ full
หรือ property-KEY
เท่านั้น
ตารางต่อไปนี้อธิบายค่าการฉายภาพที่รองรับ
ชื่อการคาดการณ์ | คำอธิบาย |
---|---|
thin |
จะไม่มีการอัปเดตหรืออัปเดตเอลิเมนต์ gd:extendedProperty |
property-KEY |
KEY บ่งชี้คีย์ของพร็อพเพอร์ตี้เพิ่มเติม (องค์ประกอบ gd:extendedProperty ) ที่ส่งคืน (สำหรับคำขอ GET ) หรือควรอัปเดต (สำหรับคำขอ PUT หรือ POST ) หากไม่ได้ใช้พร็อพเพอร์ตี้ที่ขยายในระหว่างการอัปเดต ระบบจะลบพร็อพเพอร์ตี้ออก |
full
| ระบบจะแสดงผลเอลิเมนต์ gd:extendedProperty ทั้งหมดและ
ต้องรวมเอลิเมนต์ทั้งหมดในระหว่างการอัปเดต |