API người dùng cho phép bạn:
- Đọc và quản lý Danh bạ của người dùng đã xác thực
- Đọc và sao chép "Danh bạ khác" của người dùng đã xác thực
- Đọc thông tin hồ sơ của người dùng đã xác thực và danh bạ của họ
- Đọc danh bạ và hồ sơ trên miền
Ví dụ: giả sử người dùng đã xác thực, Jen, có Fabian và Ranjith trong danh bạ riêng tư của cô ấy. Khi ứng dụng của bạn gọi people.connections.list để đọc danh sách các kết nối của mình, Jen sẽ thấy một màn hình yêu cầu đồng ý yêu cầu cấp cho ứng dụng quyền truy cập vào danh sách đó. Nếu Jen đồng ý, ứng dụng sẽ đọc danh sách chứa person resources cho Fabian và Ranjith.
Nếu cần thông tin cho một người dùng cụ thể, ứng dụng có thể gọi people.get bằng cách truyền tên tài nguyên để lấy person resource cho người đó.
Ứng dụng cũng có thể quản lý danh bạ bằng cách tạo danh bạ mới bằng people.createContact, cập nhật danh bạ hiện có mà ứng dụng đã đọc từ people.connections.list bằng cách sử dụng people.updateContact và xoá danh bạ bằng people.deleteContact.
Người dùng Google Workspace cũng có thể liệt kê hồ sơ miền trong thư mục và người liên hệ trong miền bằng people.listDirectoryPeople hoặc tìm kiếm bằng people.searchDirectoryPeople.
Chế độ xem hợp nhất về thông tin mọi người
Thông tin về mọi người mà API Người đọc đọc được hợp nhất từ nhiều nguồn, tuỳ thuộc vào các điều kiện sau:
| Nguồn | Điều kiện |
|---|---|
| Dữ liệu hồ sơ công khai trên Google | Luôn luôn. |
| Dữ liệu hồ sơ trên miền Google Workspace | Quản trị viên miền đã bật tính năng liên hệ bên ngoài và chia sẻ hồ sơ của dữ liệu trong phạm vi miền, đồng thời phạm vi directory.readonly đã được cấp |
| Thông tin hồ sơ riêng tư của người dùng đã xác thực | Một trong các phạm vi profile đã được cấp. |
| Danh bạ của người dùng đã xác thực | Phạm vi contacts đã được cấp. |
Tìm hiểu về dữ liệu người hợp nhất
Dữ liệu về một người bắt nguồn từ một loại nguồn chính. Dữ liệu từ các nguồn khác được hợp nhất với dữ liệu này nếu các nguồn được kết nối thông qua địa chỉ email, số điện thoại hoặc URL hồ sơ đã xác minh. Dưới đây là những cách mà một người có thể được soạn:
| Nguồn chính | Danh bạ | Hồ sơ | Hồ sơ trên miền Google Workspace | Thông tin liên hệ của miền Google Workspace | Cách sử dụng |
|---|---|---|---|---|---|
| Thông tin liên hệ | 1 | 0 trở lên | 0 trở lên | 0 trở lên | Đã trả về cho hầu hết các điểm cuối |
| Hồ sơ | 0 trở lên | 1 | 0 hoặc 1 | 0 | Được trả về trong people.get khi yêu cầu được dùng để lấy người cho người dùng đã đăng nhập hoặc lấy một người cho Tài khoản Google của người dùng khác. |
| Thông tin liên hệ của miền | 0 trở lên | 0 | 0 | 1 | Đã trả bài vào people.listDirectoryPeople hoặc people.searchDirectoryPeople. |
Chỉ những người dựa trên thông tin liên hệ mới có thể được sửa đổi bằng điểm cuối của đột biến. Thay đổi thông tin liên hệ trên miền và hồ sơ không được hỗ trợ.