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

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แอตทริบิวต์อย่างใดอย่างหนึ่ง แต่จะระบุทั้ง 2 อย่างไม่ได้

  • 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 สำหรับกลุ่มที่ผู้ติดต่อไม่ได้เป็นสมาชิกอีกต่อไป