Tham số truy vấn về danh bạ

API Danh bạ dùng chung của miền hỗ trợ các tham số truy vấn API Dữ liệu Google tiêu chuẩn sau:

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 người liên hệ thay vì chỉ nhận số lượng tối đa mặc định, bạn có thể chỉ định một số 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 (để phân trang).
updated-min Giới hạn dưới của ngày cập nhật mục nhập.

Để biết thêm thông tin về các tham số 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 tiêu chuẩn, API Danh bạ được chia sẻ trong miền cò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

Đưa người liên hệ đã xoá vào nguồn cấp dữ liệu người liên hệ được trả về. Các giá trị hợp lệ là true hoặc false. Các liên hệ dùng chung đã xoá sẽ hiển thị dưới dạng các mục không chứa gì ngoài 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 các 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.