People API

Cấp quyền truy cập vào thông tin về hồ sơ và danh bạ.

Dịch vụ: people.googleapis.com

Để gọi dịch vụ này, bạn nên sử dụng thư viện ứng dụng do Google cung cấp. Nếu ứng dụng của bạn cần sử dụng thư viện của riêng bạn để gọi dịch vụ này, hãy sử dụng thông tin sau đây khi đưa ra yêu cầu API.

Tài liệu khám phá

Tài liệu khám phá là một thông số kỹ thuật mà máy đọc được để mô tả và sử dụng các API REST. API này được dùng để xây dựng thư viện ứng dụng, trình bổ trợ IDE và các công cụ khác tương tác với các API của Google. Một dịch vụ có thể cung cấp nhiều tài liệu khám phá. Dịch vụ này cung cấp tài liệu khám phá sau đây:

Điểm cuối dịch vụ

Điểm cuối dịch vụ là một URL cơ sở chỉ định địa chỉ mạng của dịch vụ API. Một dịch vụ có thể có nhiều điểm cuối dịch vụ. Dịch vụ này có điểm cuối của dịch vụ sau đây và tất cả các URI bên dưới đều liên quan đến điểm cuối của dịch vụ này:

  • https://people.googleapis.com

Tài nguyên REST: v1.contactGroups

Phương thức
batchGet GET /v1/contactGroups:batchGet
Nhận danh sách nhóm liên hệ do người dùng đã xác thực sở hữu bằng cách chỉ định danh sách tên tài nguyên của nhóm liên hệ.
create POST /v1/contactGroups
Tạo một nhóm liên hệ mới do người dùng đã xác thực sở hữu.
delete DELETE /v1/{resourceName=contactGroups/*}
Xoá một nhóm liên hệ hiện có do người dùng đã xác thực sở hữu bằng cách chỉ định tên tài nguyên của nhóm liên hệ đó.
get GET /v1/{resourceName=contactGroups/*}
Lấy một nhóm liên hệ cụ thể do người dùng đã xác thực sở hữu bằng cách chỉ định tên tài nguyên của nhóm liên hệ đó.
list GET /v1/contactGroups
Liệt kê tất cả các nhóm liên hệ của người dùng đã xác thực.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
Cập nhật tên của một nhóm liên hệ hiện có do người dùng đã xác thực sở hữu.

Tài nguyên REST: v1.contactGroups.members

Phương thức
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Sửa đổi các thành viên của nhóm liên hệ do người dùng đã xác thực sở hữu.

Tài nguyên REST: v1.otherContacts

Phương thức
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

Sao chép "Người liên hệ khác" vào một người liên hệ mới trong nhóm "myDanh bạ" của người dùng

Thay đổi yêu cầu cho cùng một người dùng phải được gửi tuần tự để tránh tăng độ trễ và lỗi.

list GET /v1/otherContacts
Liệt kê tất cả "Người liên hệ khác", tức là những người liên hệ không nằm trong nhóm người liên hệ.
search GET /v1/otherContacts:search
Cung cấp danh sách người liên hệ trong danh bạ khác của người dùng đã xác thực khớp với cụm từ tìm kiếm.

Tài nguyên REST: v1.people

Phương thức
batchCreateContacts POST /v1/people:batchCreateContacts

Tạo một loạt địa chỉ liên hệ mới và trả về PersonResponses cho

Thay đổi yêu cầu cho cùng một người dùng phải được gửi tuần tự để tránh tăng độ trễ và lỗi.

batchDeleteContacts POST /v1/people:batchDeleteContacts
Xoá một loạt người liên hệ.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Cập nhật một loạt người liên hệ và trả về một bản đồ tên tài nguyên cho phản hồi của người liên hệ cho những người liên hệ đã cập nhật.
createContact POST /v1/people:createContact
Tạo một người liên hệ mới và trả về tài nguyên người cho mục liên hệ đó.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Xoá người liên hệ.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Xoá ảnh của người liên hệ.
get GET /v1/{resourceName=people/*}
Cung cấp thông tin về một người bằng cách chỉ định tên tài nguyên.
getBatchGet GET /v1/people:batchGet
Cung cấp thông tin về danh sách những người cụ thể bằng cách chỉ định danh sách tên tài nguyên được yêu cầu.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Cung cấp danh sách các hồ sơ trên miền và thông tin liên hệ trên miền trong thư mục miền của người dùng đã xác thực.
searchContacts GET /v1/people:searchContacts
Cung cấp danh sách người liên hệ trong danh bạ được nhóm lại của người dùng đã xác thực khớp với cụm từ tìm kiếm.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Cung cấp danh sách các hồ sơ trên miền và thông tin liên hệ trên miền trong thư mục miền của người dùng đã xác thực khớp với cụm từ tìm kiếm.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Cập nhật dữ liệu liên hệ cho một người liên hệ hiện có.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
Cập nhật ảnh của một người liên hệ.

Tài nguyên REST: v1.people.connections

Phương thức
list GET /v1/{resourceName=people/*}/connections
Cung cấp danh sách liên hệ của người dùng đã xác thực.