คุณสามารถส่งคำขอรายชื่อติดต่อของผู้ใช้ที่แชร์ได้หลายวิธี ด้วยวิธีต่อไปนี้
- รายชื่อติดต่อที่แชร์ทั้งหมด
- ชุดรายชื่อติดต่อที่ตรงกับเกณฑ์ที่ระบุ
- รายชื่อติดต่อที่แชร์รายการเดียว
- รูปภาพสำหรับรายชื่อติดต่อ
โดยค่าเริ่มต้น รายการในฟีดจะไม่เรียงลำดับ
รับรายชื่อติดต่อที่แชร์ทั้งหมด
หากต้องการรับรายชื่อติดต่อที่แชร์ทั้งหมด ให้ส่งคำขอ HTTP
GET
ไปยัง URL ของฟีดรายชื่อติดต่อ:GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION
โดยแทนที่ค่าต่อไปนี้
DOMAIN
: URL สำหรับโดเมน เช่น example.comPROJECTION
: ค่าฉายภาพที่ระบุ องค์ประกอบgd:extendedProperty
โปรดดูรายการค่าที่รองรับที่หัวข้อ ค่าการฉายภาพ
ฟีดจะแสดงรหัสสถานะ
HTTP 200 OK
และ Atom 1.0 มาตรฐาน ที่มีรายชื่อติดต่อ ต่อไปนี้เป็นตัวอย่างของรายชื่อติดต่อ ฟีดที่มีรายการเดียวเท่านั้น ได้แก่<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gd='http://schemas.google.com/g/2005' xmlns:gContact='http://schemas.google.com/contact/2008' xmlns:batch='http://schemas.google.com/gdata/batch'> <id>https://www.google.com/m8/feeds/contacts/example.com/base</id> <updated>2008-03-05T12:36:38.836Z</updated> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#contact' /> <title type='text'>example.com's Contacts</title> <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full' /> <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full' /> <link rel='http://schemas.google.com/g/2005#batch' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' /> <link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' /> <author> <name>example.com</name> <email>example.com</email> </author> <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'> Contacts </generator> <openSearch:totalResults>1</openSearch:totalResults> <openSearch:startIndex>1</openSearch:startIndex> <openSearch:itemsPerPage>25</openSearch:itemsPerPage> <entry> <id> https://www.google.com/m8/feeds/contacts/example.com/base/c9012de </id> <updated>2008-03-05T12:36:38.835Z</updated> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#contact' /> <title type='text'>Fitzgerald</title> <gd:name> <gd:fullName>Fitzgerald</gd:fullName> </gd:name> <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/> <link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' /> <link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' /> <gd:phoneNumber rel='http://schemas.google.com/g/2005#home' primary='true'> 456 </gd:phoneNumber> <gd:extendedProperty name="pet" value="hamster" /> </entry> </feed>
ฟีดแสดงผลไม่เกิน 10 MB ในการตอบกลับครั้งเดียว ถึง ดูรายการรายชื่อติดต่อทั้งหมด แล้วติดตามฟีดที่แสดงซ้ำๆ ถัดไปจนกว่าคุณจะไม่เห็นลิงก์นั้นในฟีดการคืนสินค้าอีกต่อไป
รับรายชื่อติดต่อที่แชร์โดยใช้พารามิเตอร์การค้นหา
คุณสามารถขอชุดรายชื่อติดต่อที่ตรงกับที่ระบุ เช่น การขอให้อัปเดตรายชื่อติดต่อหลังจากวันที่ที่กำหนด ไม่มี รองรับการสอบถามด้วยข้อความแบบเต็มหรือค้นหาผู้ติดต่อตามที่อยู่อีเมล สำหรับ รายการพารามิเตอร์การค้นหาที่รองรับทั้งหมด โปรดดู คู่มืออ้างอิงสำหรับ API รายชื่อติดต่อที่แชร์ในโดเมน
ส่งคำขอ
HTTP GET
ไปยัง URL ของฟีดรายชื่อติดต่อพร้อมข้อความที่กำหนดไว้ พารามิเตอร์:GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
โดยแทนที่ค่าต่อไปนี้
DOMAIN
: URL สำหรับโดเมน เช่น example.comPROJECTION
: ค่าฉายภาพที่ระบุ องค์ประกอบgd:extendedProperty
โปรดดูรายการค่าที่รองรับที่หัวข้อ ค่าการฉายภาพPARAMETER
: หนึ่งในคำค้นหาที่รองรับ พารามิเตอร์ สำหรับข้อมูลเพิ่มเติม โปรดดู คู่มืออ้างอิงสำหรับ API รายชื่อติดต่อที่แชร์ในโดเมน
เช่น หากต้องการอัปเดตรายการรายชื่อติดต่อที่แชร์ในโดเมนทั้งหมดหลังจาก 16 มีนาคม 2022 สำหรับ example.com ให้ส่งคำขอ HTTP ไปยังโดเมนที่แชร์ URL ของฟีดรายชื่อติดต่อและเพิ่มพารามิเตอร์
updated-min
ลงใน URL คำขอGET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
เมื่อคุณส่งคำขอ
GET
นั้น เซิร์ฟเวอร์จะส่งกลับ HTTP200 OK
รหัสสถานะ และฟีดที่มีที่อยู่ติดต่อที่แชร์ของโดเมนที่ สร้างหรืออัปเดตหลังจากวันที่ระบุฟีดแสดงผลไม่เกิน 10 MB ในการตอบกลับครั้งเดียว ถึง ดูรายการรายชื่อติดต่อทั้งหมดพร้อมเกณฑ์ที่ระบุซ้ำๆ คลิกลิงก์ถัดไปของฟีดที่แสดงผลจนกว่าคุณจะไม่เห็นลิงก์นั้น ในฟีดการคืนสินค้า
ติดตามการเปลี่ยนแปลงที่เพิ่มขึ้น
หากต้องการติดตามการเปลี่ยนแปลงเพิ่มในรายการรายชื่อติดต่อที่แชร์ของโดเมน ให้ทำดังนี้
ดังต่อไปนี้:
1. เมื่อคุณส่งคำขอฟีด ให้ติดตามค่าของฟีด
องค์ประกอบ <updated>
ของฟีด
1. คุณสามารถรับเฉพาะรายชื่อติดต่อที่แชร์ของโดเมนซึ่งมีการเปลี่ยนแปลงตั้งแต่
คำขอก่อนหน้าโดยการตั้งค่าพารามิเตอร์การค้นหา
updated-min
เป็นค่า <updated>
ดังกล่าวและการตั้งค่า
showdeleted
ถึง true
รับรายชื่อติดต่อที่แชร์รายการเดียว
หากต้องการได้รายชื่อติดต่อที่แชร์รายการเดียว คุณต้องใช้ลิงก์ตัวเองของรายชื่อติดต่อนั้น คุณสามารถ รับเฉพาะลิงก์ตนเองของผู้ติดต่อที่แชร์ โดยค้นหารายการของผู้ติดต่อใน ฟีดรายชื่อติดต่อที่แชร์ หากไม่แน่ใจว่าควรใช้ค่าใดสำหรับลิงก์ตัวเอง ดูรับรายชื่อติดต่อทั้งหมด และ รับรายชื่อติดต่อโดยใช้พารามิเตอร์การค้นหา
- หากต้องการรับรายชื่อติดต่อที่แชร์ของโดเมนที่เจาะจง ให้ส่ง HTTP
GET
คำขอลิงก์ตัวเองของผู้ติดต่อ โดยแทนที่ค่าต่อไปนี้GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
DOMAIN
: URL สำหรับโดเมนของคุณ เช่น example.comPROJECTION
: ค่าการคาดคะเนที่ระบุฟิลด์gd:extendedProperty
องค์ประกอบ โปรดดูรายการค่าที่รองรับที่หัวข้อ ค่าการฉายภาพSELF_LINK
: ค่าตัวเลขที่ไม่ซ้ำกันซึ่งแสดงค่า รายชื่อติดต่อที่แชร์รายการเดียว เช่น 12345
จากนั้นเซิร์ฟเวอร์จะส่งคืนรหัสสถานะ HTTP 200 OK
และรายการที่มี
รายชื่อติดต่อ
ตัวอย่างเช่น หากต้องการกำหนดให้รายชื่อติดต่อที่แชร์ในโดเมนมีการตั้งค่าลิงก์ของตนเองเป็น
https://www.google.com/m8/feeds/contacts/example.com/full/12345
โปรดส่ง
คำขอ HTTP ต่อไปนี้:
GET https://www.google.com/m8/feeds/contacts/example.com/full/12345