Trang này được dịch bởi Cloud Translation API.

Lấy danh bạ dùng chung

Bạn có thể yêu cầu chia sẻ thông tin liên hệ của người dùng theo nhiều cách:

Tất cả người liên hệ được chia sẻ
Một nhóm địa chỉ liên hệ phù hợp với tiêu chí được chỉ định
Một người liên hệ dùng chung
Ả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 theo thứ tự.

Lấy tất cả người liên hệ được chia sẻ

Để xem tất cả danh bạ đã chia sẻ, hãy gửi 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ế đoạn mã sau:

DOMAIN: URL cho miền của bạn, ví dụ: example.com.
PROJECTION: Giá trị phép chiếu chỉ định các phần tử gd:extendedProperty. Để biết danh sách các giá trị được hỗ trợ, hãy xem phần Giá trị phép chiếu.

Nguồn cấp dữ liệu này sẽ trả về mã trạng thái HTTP 200 OK và nguồn cấp dữ liệu Atom 1.0 tiêu chuẩn có chứa người liên hệ đó. Sau đây là ví dụ về nguồn cấp dữ liệu danh bạ chỉ 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>

Nguồn cấp dữ liệu không trả về quá 10 MB trong một phản hồi. Để tải toàn bộ danh sách liên hệ, hãy liên tục nhấp vào đường liên kết Next (Tiếp theo) của nguồn cấp dữ liệu được trả về cho đến khi bạn không còn thấy đường liên kết đó trong nguồn cấp dữ liệu trả về.

Nhận danh bạ được chia sẻ bằng cách sử dụng các tham số truy vấn

Bạn có thể yêu cầu một nhóm thông tin liên hệ phù hợp với một tiêu chí đã chỉ định, chẳng hạn như yêu cầu cập nhật danh bạ sau một ngày nhất định. Chúng tôi không hỗ trợ các truy vấn dạng văn bản đầy đủ hoặc tính năng xác định vị trí người liên hệ theo địa chỉ email. Để biết danh sách đầy đủ các tham số truy vấn được hỗ trợ, hãy xem Hướng dẫn tham khảo API Danh bạ được chia sẻ trên miền.

Gửi yêu cầu HTTP GET đến URL nguồn cấp dữ liệu danh bạ bằng một thông số đã xác định:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
Thay thế đoạn mã sau:
- DOMAIN: URL cho miền của bạn, ví dụ: example.com.
- PROJECTION: Giá trị phép chiếu chỉ định các phần tử gd:extendedProperty. Để biết danh sách các giá trị được hỗ trợ, hãy xem phần Giá trị phép chiếu.
- PARAMETER: Một trong các tham số truy vấn được hỗ trợ. Để biết thêm thông tin, hãy xem Hướng dẫn tham khảo API Danh bạ được chia sẻ trên miền.
Ví dụ: để cập nhật toàn bộ thông tin liên hệ được chia sẻ của miền sau ngày 16 tháng 3 năm 2022 cho example.com, hãy gửi yêu cầu HTTP đến URL nguồn cấp dữ liệu liên hệ được chia sẻ của miền và thêm tham số updated-min vào URL yêu cầu:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
Khi bạn gửi yêu cầu GET đó, máy chủ sẽ trả về một mã trạng thái HTTP 200 OK và một nguồn cấp dữ liệu chứa mọi người liên hệ dùng chung trên miền đã được tạo hoặc cập nhật sau ngày được chỉ định.
Nguồn cấp dữ liệu không trả về quá 10 MB trong một phản hồi. Để tải toàn bộ danh sách liên hệ với các tiêu chí đã chỉ định, hãy liên tục nhấp vào đường liên kết Next (Tiếp theo) của nguồn cấp dữ liệu được trả về cho đến khi bạn không còn thấy đường liên kết đó trong nguồn cấp dữ liệu trả về.

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

Để theo dõi các thay đổi gia tăng đối với danh bạ dùng chung trên miền, hãy làm như sau: 1. Khi bạn gửi một yêu cầu cho một nguồn cấp dữ liệu, hãy theo dõi giá trị của phần tử <updated> trong nguồn cấp dữ liệu đó. 1. Bạn chỉ có thể lấy danh bạ được chia sẻ trên miền đã thay đổi kể từ yêu cầu trước đó bằng cách đặt tham số truy vấn updated-min thành giá trị <updated> đó và đặt showdeleted thành true.

Tạo một người liên hệ được chia sẻ duy nhất

Để có một người liên hệ dùng chung, bạn phải sử dụng đường liên kết tự liên kết của người liên hệ đó. Bạn chỉ có thể lấy đường liên kết tự liên kết của người liên hệ được chia sẻ bằng cách tìm mục nhập của người liên hệ đó trong nguồn cấp dữ liệu danh bạ được chia sẻ. Nếu bạn không chắc nên sử dụng giá trị nào cho quá trình tự liên kết, hãy xem phần Lấy tất cả thông tin liên hệ và Lấy thông tin liên hệ bằng cách sử dụng các tham số truy vấn.

Để lấy một người liên hệ dùng chung trong miền cụ thể, hãy gửi yêu cầu HTTP GET đến phương thức tự liên kết của một người liên hệ:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
```
Thay thế những thông tin sau:

DOMAIN: URL cho miền của bạn, ví dụ: example.com.
PROJECTION: Giá trị phép chiếu chỉ định các phần tử gd:extendedProperty. Để biết danh sách các giá trị được hỗ trợ, hãy xem phần Giá trị phép chiếu.
SELF_LINK: Một giá trị số duy nhất đại diện cho một người liên hệ dùng chung duy nhất, ví dụ: 12345.

Sau đó, máy chủ sẽ trả về mã trạng thái HTTP 200 OK và một mục chứa người liên hệ đó.

Ví dụ: để yêu cầu một địa chỉ liên hệ được chia sẻ trên miền có chế độ tự liên kết được đặt thành https://www.google.com/m8/feeds/contacts/example.com/full/12345, hãy gửi yêu cầu HTTP sau:

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

Các bước tiếp theo

Chụp ảnh về người liên hệ được chia sẻ