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 danh bạ người dùng được chia sẻ theo nhiều cách cách:

Tất cả người liên hệ được chia sẻ
Một nhóm mục liên hệ đáp ứng một tiêu chí cụ thể
Một liên hệ dùng chung duy nhất
Ảnh của một người liên hệ

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

Lấy tất cả địa chỉ liên hệ được chia sẻ

Để nhận tất cả địa chỉ liên hệ được 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ụ: vidu.com.
PROJECTION: Giá trị phép chiếu chỉ định phần tử gd:extendedProperty. Để biết danh sách giá trị được hỗ trợ, hãy xem Giá trị chiếu.

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

Nguồn cấp dữ liệu không trả về quá 10 MB trong một phản hồi. Người nhận lấy toàn bộ danh bạ, liên tục theo dõi Đường liên kết Tiếp theo 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ả lại hàng.

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

Bạn có thể yêu cầu một nhóm địa chỉ liên hệ khớp với chẳng hạn như yêu cầu cập nhật người liên hệ sau một ngày nhất định. Không có hỗ trợ đối với các truy vấn bằng văn bản đầy đủ hoặc xác định vị trí liên hệ bằng địa chỉ email. Đối với 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ạ có chứa tham số:
```
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ụ: vidu.com.
- PROJECTION: Giá trị phép chiếu chỉ định phần tử gd:extendedProperty. Để biết danh sách các giá trị được hỗ trợ, hãy xem Giá trị chiếu.
- PARAMETER: Một trong những truy vấn được hỗ trợ tham số. Để 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 tất cả các mục thông tin liên hệ dùng chung của miền sau Ngày 16 tháng 3 năm 2022 trên example.com, gửi yêu cầu HTTP đến miền được chia sẻ liên hệ với URL nguồn cấp dữ liệu 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 HTTP 200 OK mã trạng thái và nguồn cấp dữ liệu chứa bất kỳ địa chỉ liên hệ được chia sẻ nào trong miền được tạo hoặc cập nhật sau ngày đã chỉ định.
Nguồn cấp dữ liệu không trả về quá 10 MB trong một phản hồi. Người nhận lấy toàn bộ danh sách liên hệ với các tiêu chí đã chỉ định, lặp đi lặp lại truy cập vào đường liên kết 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ả lại hàng.

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

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

Nhận một liên hệ dùng chung duy nhất

Để xem 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 có thể chỉ 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 sách liên hệ được chia sẻ. Nếu bạn không biết chắc nên dùng giá trị nào cho đường tự liên kết, xem Tải tất cả người liên hệ và Nhận địa chỉ liên hệ bằng cách sử dụng tham số truy vấn.

Để nhận thông tin liên hệ được chia sẻ trên một miền cụ thể, hãy gửi một HTTP GET yêu cầu 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ế đoạn mã sau:

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

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

Ví dụ: để lấy người liên hệ được chia sẻ trong miền có đường liên kết tự đặt thành https://www.google.com/m8/feeds/contacts/example.com/full/12345, hãy gửi theo 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

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