Lấy danh bạ dùng chung

Yêu cầu thông tin liên hệ của người dùng được chia sẻ theo những cách sau:

  • Tất cả thông tin liên hệ được chia sẻ
  • Một nhóm thông tin liên hệ phù hợp với tiêu chí đã chỉ định
  • Một thông tin liên hệ được chia sẻ
  • Ảnh của một 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ả thông tin liên hệ được chia sẻ

  1. Để lấy tất cả thông tin liên hệ được chia sẻ, hãy gửi yêu cầu GET HTTP đến URL nguồn cấp dữ liệu về thông tin liên hệ:

    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ị chiếu. Để biết các giá trị được hỗ trợ, hãy xem Giá trị chiếu.

    Máy chủ sẽ 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 minh hoạ nguồn cấp dữ liệu về thông tin liên hệ có một mục:

    <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. Để lấy toàn bộ danh sách, hãy lặp lại việc 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 thông tin liên hệ được chia sẻ bằng cách sử dụng tham số truy vấn

Yêu cầu thông tin liên hệ phù hợp với tiêu chí đã chỉ định, chẳng hạn như thông tin liên hệ được cập nhật sau một ngày nhất định. Không hỗ trợ truy vấn toàn văn bản và tra cứu địa chỉ email. Để biết tất 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 về thông tin liên hệ có tham số:

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

    Thay thế nội dung sau:

    • DOMAIN: Miền của bạn, ví dụ: example.com.
    • PROJECTION: Giá trị chiếu. Để biết các giá trị được hỗ trợ, hãy xem Giá trị chiếu.
    • PARAMETER: Tham số truy vấn được hỗ trợ. Xem hướng dẫn tham khảo về Domain Shared Contacts API.

    Ví dụ: để lấy 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ủ sẽ trả về mã trạng thái HTTP 200 OK và nguồn cấp dữ liệu có mọi kết quả phù hợp.

  2. Nguồn cấp dữ liệu trả về tối đa 10 MB trong một phản hồi. Để lấy toàn bộ danh sách, hãy lặp lại việc nhấ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 sách thông tin liên hệ được chia sẻ trong 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 thông tin liên hệ đã thay đổi bằng cách đặt updated-min thành giá trị <updated> đó và đặt showdeleted thành true.

Lấy một thông tin liên hệ được chia sẻ

Để lấy một thông tin liên hệ cụ thể, hãy sử dụng đường liên kết tự liên kết 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 về thông tin liên hệ được chia sẻ. Để biết thêm thông tin, hãy xem bài viết Lấy tất cả thông tin liên hệ được chia sẻ.

  1. Để lấy một thông tin 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ị chiếu. Để biết các giá trị được hỗ trợ, hãy xem Giá trị chiếu.
  • SELF_LINK: Giá trị số duy nhất của người liên hệ.

Máy chủ sẽ trả về mã trạng thái HTTP 200 OK và mục thông tin liên hệ.

Ví dụ: để lấy thông tin liên hệ có đường liên kết tự liên kết 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