Tham số truy vấn danh bạ

API Danh bạ được chia sẻ của miền hỗ trợ các tham số truy vấn API dữ liệu tiêu chuẩn sau đây của Google:

Tên Mô tả
alt Loại nguồn cấp dữ liệu cần trả về, chẳng hạn như atom (mặc định), rss hoặc json.
max-results Số mục nhập tối đa cần trả về. Nếu muốn nhận mọi thông tin liên hệ, thay vì chỉ nhận giá trị tối đa mặc định, bạn có thể chỉ định một số lượng lớn cho max-results.
start-index Chỉ mục dựa trên 1 của kết quả đầu tiên cần truy xuất (dành cho chức năng phân trang).
updated-min Giới hạn dưới cho ngày cập nhật mục nhập.

Để biết thêm thông tin về các tham số tiêu chuẩn, hãy xem Tài liệu tham khảo về giao thức API Dữ liệu của Google.

Ngoài các tham số truy vấn chuẩn, API Danh bạ được chia sẻ trên miền hỗ trợ các tham số sau:

Tên Mô tả
orderby Tiêu chí sắp xếp. Giá trị duy nhất được hỗ trợ là lastmodified.
showdeleted

Bao gồm những người liên hệ đã bị xóa trong nguồn cấp dữ liệu danh bạ được trả về. Các giá trị hợp lệ là true hoặc false. Danh bạ dùng chung đã bị xoá sẽ hiển thị dưới dạng các mục nhập không chứa phần tử <atom:id> và phần tử <gd:deleted>.

Google giữ lại phần giữ chỗ cho những người liên hệ dùng chung đã bị xoá trong 30 ngày sau khi xoá. Trong thời gian đó, bạn có thể yêu cầu phần giữ chỗ bằng cách sử dụng tham số truy vấn showdeleted.

sortorder Hướng thứ tự sắp xếp. Có thể là ascending hoặc descending.