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

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

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

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

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

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

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

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

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

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

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

    เช่น หากต้องการอัปเดตรายการรายชื่อติดต่อที่แชร์ในโดเมนทั้งหมดหลังจาก 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. หากต้องการรับรายชื่อติดต่อที่แชร์ของโดเมนที่เจาะจง ให้ส่ง HTTP GET คำขอลิงก์ตัวเองของผู้ติดต่อ
    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

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