องค์ประกอบรายชื่อติดต่อที่แชร์

Domain Shared Contacts API ใช้องค์ประกอบ Google Data API มาตรฐานและองค์ประกอบเฉพาะสำหรับรายชื่อติดต่อที่แชร์

รายการติดต่ออยู่ในรูปแบบประเภทรายชื่อติดต่อแบบขยาย ซึ่งแสดงถึงบุคคล สถานที่ตั้ง เช่น คลับหรือร้านอาหาร หรือองค์กร ประเภทรายชื่อติดต่อจะปรากฏใน XML เป็นองค์ประกอบ <atom:entry> ที่มีองค์ประกอบส่วนขยายต่างๆ จากเนมสเปซ Google Data

องค์ประกอบ category ที่ระบุว่ารายการเป็นรายชื่อติดต่อมีลักษณะดังนี้

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

ใน Domain Shared Contacts API องค์ประกอบหลายอย่างมีข้อจำกัดมากกว่าประเภทรายชื่อติดต่อเล็กน้อย สำหรับองค์ประกอบต่อไปนี้ คุณต้องระบุแอตทริบิวต์ rel หรือแอตทริบิวต์ label เท่านั้น

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

เมื่อคุณสร้างหรืออัปเดตรายชื่อติดต่อที่แชร์ หากคุณระบุทั้ง rel และ label หรือไม่ได้ระบุองค์ประกอบใดเลย เซิร์ฟเวอร์จะปฏิเสธรายการดังกล่าว

การสนับสนุนของ Photos

คุณสามารถใช้ค่า rel สำหรับองค์ประกอบ atom:link ร่วมกับค่าของพร็อพเพอร์ตี้มาตรฐาน เช่น self หรือ edit เมื่อใช้ลิงก์รูปภาพ คุณต้องระบุโทเค็นการให้สิทธิ์ในส่วนหัว HTTP ดูข้อมูลเพิ่มเติมได้ที่ดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์

  • เมื่อใช้คำสั่ง GET rel="http://schemas.google.com/contacts/2008/rel#photo" จะเพิ่มความสามารถในการอ่านรูปภาพที่เชื่อมโยงกับรายชื่อติดต่อ คุณสามารถใช้ URL ที่ระบุไว้ใน href เพื่ออ่านรูปภาพเวอร์ชันล่าสุดที่เชื่อมโยงกับรายชื่อติดต่อได้ ลิงก์จะไม่แสดงหากไม่มีรูปภาพสำหรับรายชื่อติดต่อ

ตัวอย่าง

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • เมื่อใช้คำสั่ง PUT หรือ DELETE rel="http://schemas.google.com/contacts/2008/rel#edit-photo" จะเพิ่มความสามารถในการอัปเดตหรือลบรูปภาพในเครื่องที่เชื่อมโยงกับผู้ติดต่อ

ตัวอย่าง

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

เนมสเปซ gContact

URL ของเนมสเปซ XML สำหรับ gContact คือ http://schemas.google.com/contact/2008

ในเนมสเปซนี้จะมีการกำหนดองค์ประกอบที่แสดงถึงกลุ่มที่รายชื่อติดต่อนั้นอยู่

ที่พัก gContact:groupMembershipInfo แห่ง

พร็อพเพอร์ตี้ คำอธิบาย
href ระบุกลุ่มที่ผู้ติดต่อเป็นสมาชิกหรือเคยเป็นสมาชิก ระบบจะอ้างอิงกลุ่มตามรหัส
deleted="true" หมายความว่ามีการนำการเป็นสมาชิกกลุ่มออกจากรายชื่อติดต่อ ระบบจะรวมแอตทริบิวต์นี้เฉพาะในกรณีที่ระบุ showdeleted เป็นพารามิเตอร์การค้นหาเท่านั้น ไม่เช่นนั้นระบบจะไม่แสดง groupMembershipInfo สำหรับกลุ่มที่ผู้ติดต่อไม่ได้อยู่ในกลุ่มแล้ว