- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Thu thập
- Hãy làm thử!
Lấy tập hợp người chơi cho người dùng hiện đã được xác thực.
Yêu cầu HTTP
GET https://games.googleapis.com/games/v1/players/me/players/{collection}
Tham số đường dẫn
Tham số | |
---|---|
collection |
Tập hợp người chơi đang được truy xuất |
Tham số truy vấn
Tham số | |
---|---|
language |
Ngôn ngữ ưu tiên sử dụng cho các chuỗi được phương thức này trả về. |
maxResults |
Số tài nguyên tối đa của người chơi được trả về trong phản hồi, dùng cho tính năng phân trang. Đối với bất kỳ phản hồi nào, số lượng tài nguyên thực tế của người chơi được trả về có thể nhỏ hơn |
pageToken |
Mã thông báo do yêu cầu trước đó trả về. |
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 danh sách người chơi của bên thứ ba.
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 |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
nextPageToken |
Mã thông báo tương ứng với trang kết quả tiếp theo. |
items[] |
Người chơi. |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Bộ sưu tập
Enum | |
---|---|
CONNECTED |
Truy xuất danh sách những người chơi cũng đang chơi trò chơi này theo trình tự thời gian ngược. |
VISIBLE |
Truy xuất danh sách người chơi trong biểu đồ xã hội của người dùng mà trò chơi này hiển thị. |
FRIENDS_ALL |
Truy xuất danh sách người chơi là bạn bè của người dùng theo thứ tự bảng chữ cái. |