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