ดูรายชื่อติดต่อที่แชร์

คุณขอรายชื่อติดต่อที่แชร์ของผู้ใช้ได้หลายวิธีดังนี้

  • รายชื่อติดต่อที่แชร์ทั้งหมด
  • ชุดรายชื่อติดต่อที่ตรงกับเกณฑ์ที่ระบุ
  • รายชื่อติดต่อที่แชร์รายการเดียว
  • รูปภาพสำหรับรายชื่อติดต่อ

โดยค่าเริ่มต้น ระบบจะไม่จัดเรียงรายการในฟีด

ดูรายชื่อติดต่อที่แชร์ทั้งหมด

  1. หากต้องการดูรายชื่อติดต่อที่แชร์ทั้งหมด ให้ส่งคำขอ HTTP GET ไปยัง URL ของฟีดรายชื่อติดต่อ

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

    แทนที่ค่าต่อไปนี้

    • DOMAIN: URL ของโดเมน เช่น example.com
    • PROJECTION: ค่าการฉายที่ระบุองค์ประกอบ 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>

  2. ฟีดแสดงผลไม่เกิน 10 MB ในคำตอบเดียว หากต้องการดูรายชื่อติดต่อทั้งหมด ให้คลิกลิงก์ถัดไปของฟีดที่แสดงซ้ำๆ จนกว่าจะไม่พบลิงก์ดังกล่าวในฟีดที่แสดงอีก

รับรายชื่อติดต่อที่แชร์โดยใช้พารามิเตอร์การค้นหา

คุณสามารถขอชุดรายชื่อติดต่อที่ตรงกับเกณฑ์ที่ระบุ เช่น ขอรายชื่อติดต่อที่อัปเดตหลังจากวันที่หนึ่งๆ ไม่รองรับการค้นหาข้อความทั้งหมดหรือการค้นหารายชื่อติดต่อตามอีเมล ดูรายการพารามิเตอร์การค้นหาที่รองรับทั้งหมดได้ที่คู่มืออ้างอิง Domain Shared Contacts API

  1. ส่งคำขอ HTTP GET ไปยัง URL ของฟีดรายชื่อติดต่อด้วยพารามิเตอร์ที่กําหนดไว้ ดังนี้

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER

    แทนที่ค่าต่อไปนี้

    • DOMAIN: URL ของโดเมน เช่น example.com
    • PROJECTION: ค่าการฉายที่ระบุองค์ประกอบ gd:extendedProperty โปรดดูรายการค่าที่รองรับในหัวข้อค่าการฉายภาพ
    • PARAMETER: พารามิเตอร์การค้นหาที่รองรับรายการใดรายการหนึ่ง โปรดดูข้อมูลเพิ่มเติมที่คู่มืออ้างอิงสำหรับ Domain Shared Contacts 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 นั้น เซิร์ฟเวอร์จะแสดงรหัสสถานะ HTTP 200 OK และฟีดที่มีรายชื่อติดต่อที่แชร์โดเมนซึ่งสร้างขึ้นหรืออัปเดตหลังจากวันที่ที่ระบุ

  2. ฟีดแสดงผลไม่เกิน 10 MB ในคำตอบเดียว หากต้องการดูรายชื่อติดต่อทั้งหมดที่มีเกณฑ์ที่ระบุ ให้ไปที่ลิงก์ถัดไปของฟีดที่แสดงผลซ้ำๆ จนกว่าจะไม่พบลิงก์นั้นในฟีดที่แสดงผล

ติดตามการเปลี่ยนแปลงเพิ่มเติม

หากต้องการติดตามการเปลี่ยนแปลงที่เพิ่มขึ้นในรายชื่อติดต่อที่แชร์ของโดเมน ให้ทําดังนี้ 1. เมื่อส่งคำขอฟีด ให้ติดตามค่าขององค์ประกอบ <updated> ของฟีด 1. คุณจะได้รับเฉพาะรายชื่อติดต่อที่แชร์โดเมนซึ่งเปลี่ยนแปลงไปนับตั้งแต่คำขอก่อนหน้าโดยการตั้งค่าพารามิเตอร์การค้นหา updated-min เป็นค่า <updated> นั้น และตั้งค่า showdeleted เป็น true

รับรายชื่อติดต่อที่แชร์รายการเดียว

หากต้องการดูรายชื่อติดต่อที่แชร์รายการเดียว คุณต้องลิงก์ด้วยตนเองของรายชื่อติดต่อนั้น คุณรับได้เฉพาะลิงก์สำหรับติดต่อตนเองของผู้ติดต่อที่แชร์โดยค้นหารายการของผู้ติดต่อในฟีดรายชื่อติดต่อที่แชร์ หากไม่แน่ใจว่าควรใช้ค่าใดสำหรับลิงก์ไปยังตนเอง ให้ดูรับรายชื่อติดต่อทั้งหมด และรับรายชื่อติดต่อโดยใช้พารามิเตอร์การค้นหา

  1. หากต้องการดูรายชื่อติดต่อที่แชร์โดเมนที่เฉพาะเจาะจง ให้ส่งGETคำขอ HTTP ไปยังลิงก์ของรายชื่อติดต่อนั้น 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
     แทนที่ค่าต่อไปนี้
  • DOMAIN: URL ของโดเมน เช่น example.com
  • PROJECTION: ค่าการโปรเจ็กต์ที่ระบุองค์ประกอบ 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

ขั้นตอนถัดไป