- Yêu cầu HTTP
- Thông 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 bộ sưu tậ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
Thông số | |
---|---|
collection |
Tập hợp người chơi đang được truy xuất |
Tham số truy vấn
Thông 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 người chơi thực tế được trả về có thể ít hơn |
pageToken |
Mã thông báo được trả về bởi yêu cầu trước đó. |
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 có thể xem được. |
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. |