Lấy danh bạ dùng chung

Yêu cầu danh bạ người dùng dùng chung theo những cách sau:

  • Tất cả người liên hệ dùng chung
  • Một nhóm người liên hệ đáp ứng các tiêu chí được chỉ định
  • Một người liên hệ dùng chung
  • Ảnh của người liên hệ

Theo mặc định, các mục trong nguồn cấp dữ liệu không được sắp xếp.

Lấy tất cả người liên hệ dùng chung

  1. Để lấy tất cả các số liên hệ được chia sẻ, hãy gửi một yêu cầu HTTP GET đến URL nguồn cấp dữ liệu danh bạ:

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

    Thay thế nội dung sau:

    • DOMAIN: Miền của bạn. Ví dụ: example.com.
    • PROJECTION: Giá trị dự kiến. Để biết các giá trị được hỗ trợ, hãy xem Giá trị chiếu.

    Máy chủ trả về mã trạng thái HTTP 200 OK và nguồn cấp dữ liệu Atom 1.0. Ví dụ sau đây cho thấy một nguồn cấp dữ liệu danh bạ có một mục nhập:

    <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. Nguồn cấp dữ liệu trả về tối đa 10 MB trong một phản hồi duy nhất. Để lấy toàn bộ danh sách, hãy nhiều lần nhấp vào đường liên kết Tiếp theo trong nguồn cấp dữ liệu được trả về.

Lấy danh bạ dùng chung bằng cách sử dụng tham số truy vấn

Yêu cầu các số liên hệ khớp với tiêu chí đã chỉ định, chẳng hạn như những số liên hệ được cập nhật sau một ngày nhất định. Không hỗ trợ các truy vấn toàn văn bản và tra cứu địa chỉ email. Để biết tất cả các tham số truy vấn, hãy xem hướng dẫn tham khảo về Domain Shared Contacts API.

  1. Gửi yêu cầu HTTP GET đến URL nguồn cấp dữ liệu danh bạ bằng một tham số:

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

    Thay thế nội dung sau:

    Ví dụ: để nhận các mục được cập nhật sau ngày 16 tháng 3 năm 2022 cho example.com, hãy thêm tham số updated-min:

    GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00

    Máy chủ trả về mã trạng thái HTTP 200 OK và một nguồn cấp dữ liệu có mọi kết quả trùng khớp.

  2. Nguồn cấp dữ liệu trả về tối đa 10 MB trong một phản hồi duy nhất. Để lấy toàn bộ danh sách, hãy lặp lại việc truy cập vào đường liên kết Tiếp theo trong nguồn cấp dữ liệu được trả về.

Theo dõi các thay đổi gia tăng

Cách theo dõi các thay đổi đối với danh bạ dùng chung của miền: 1. Ghi lại giá trị của phần tử <updated> trong nguồn cấp dữ liệu. 1. Yêu cầu thay đổi danh bạ bằng cách đặt updated-min thành giá trị <updated> đó và đặt showdeleted thành true.

Lấy một người liên hệ dùng chung

Để lấy một người liên hệ cụ thể, hãy sử dụng đường liên kết tự tham chiếu của người liên hệ đó. Bạn có thể tìm thấy đường liên kết này trong nguồn cấp dữ liệu người liên hệ được chia sẻ. Để biết thêm thông tin, hãy xem phần Lấy tất cả danh bạ dùng chung.

  1. Để lấy một người liên hệ cụ thể, hãy gửi yêu cầu HTTP GET đến đường liên kết tự liên kết của người liên hệ: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
     Thay thế nội dung sau:
  • DOMAIN: Miền của bạn – ví dụ: example.com.
  • PROJECTION: Giá trị dự kiến. Để biết các giá trị được hỗ trợ, hãy xem Giá trị chiếu.
  • SELF_LINK: Giá trị bằng số duy nhất của người liên hệ.

Máy chủ trả về mã trạng thái HTTP 200 OK và mục nhập người liên hệ.

Ví dụ: để nhận một người liên hệ có đường liên kết đến chính mình https://www.google.com/m8/feeds/contacts/example.com/full/12345:

GET https://www.google.com/m8/feeds/contacts/example.com/full/12345

Các bước tiếp theo