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

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 ร่วมกับค่าของพร็อพเพอร์ตี้มาตรฐาน เช่น ตนเองหรือแก้ไขได้ เมื่อใช้ลิงก์รูปภาพ คุณจะต้องระบุโทเค็นการให้สิทธิ์ในส่วนหัว HTTP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์

  • rel="http://schemas.google.com/contacts/2008/rel#photo" เพิ่มความสามารถในการอ่านรูปภาพที่เชื่อมโยงกับรายชื่อติดต่อด้วยคำสั่ง GET คุณใช้ 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/*" />
  • rel="http://schemas.google.com/contacts/2008/rel#edit-photo" เพิ่มความสามารถในการอัปเดตหรือลบรูปภาพในเครื่องที่เชื่อมโยงกับรายชื่อติดต่อด้วยคำสั่ง PUT หรือ DELETE

ตัวอย่าง

<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 สำหรับกลุ่มที่ไม่มีรายชื่อติดต่ออีกต่อไป