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. Sử dụng people/me
để cho biết người dùng đã xác thực.
Yêu cầu này trả về lỗi 400 nếu không chỉ định "personFields".
Yêu cầu HTTP
GET https://people.googleapis.com/v1/people:batchGet
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Thông số | |
---|---|
resourceNames[] |
Bắt buộc. Tên tài nguyên của những người cần cung cấp thông tin. Lặp lại được. Tham số truy vấn URL phải là
Tài nguyên có tối đa 200 tên. |
requestMask |
KHÔNG DÙNG NỮA (Vui lòng sử dụng Một mặt nạ để giới hạn kết quả trong một nhóm nhỏ các trường chứa người dùng. |
personFields |
Bắt buộc. Mặt nạ cho trường (field mask) để hạn chế những trường được trả về cho mỗi người. Bạn có thể chỉ định nhiều trường bằng cách dùng dấu phẩy phân tách các trường. Các giá trị hợp lệ là:
|
sources[] |
Không bắt buộc. Mặt nạ cho biết các loại nguồn cần trả về. Giá trị mặc định là |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi cho yêu cầu nhận danh sách người dùng theo tên tài nguyên.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"responses": [
{
object ( |
Trường | |
---|---|
responses[] |
Phản hồi cho từng tên tài nguyên được yêu cầu. |
Phạm vi uỷ quyền
Bạn không cần phải cho phép truy cập vào dữ liệu công khai. Đối với dữ liệu riêng tư, cần phải sử dụng một trong các phạm vi OAuth sau đây:
https://www.googleapis.com/auth/contacts
https://www.googleapis.com/auth/contacts.readonly
https://www.googleapis.com/auth/contacts.other.readonly
https://www.googleapis.com/auth/directory.readonly
https://www.googleapis.com/auth/profile.agerange.read
https://www.googleapis.com/auth/profile.emails.read
https://www.googleapis.com/auth/profile.language.read
https://www.googleapis.com/auth/user.addresses.read
https://www.googleapis.com/auth/user.birthday.read
https://www.googleapis.com/auth/user.emails.read
https://www.googleapis.com/auth/user.gender.read
https://www.googleapis.com/auth/user.organization.read
https://www.googleapis.com/auth/user.phonenumbers.read
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
Để biết thêm thông tin, hãy xem bài viết Hướng dẫn uỷ quyền.