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