Method: players.list

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

enum (Collection)

Tập hợp người chơi đang được truy xuất

Tham số truy vấn

Tham số
language

string

Ngôn ngữ ưu tiên sử dụng cho các chuỗi được phương thức này trả về.
maxResults

integer

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 maxResults được chỉ định.
pageToken

string

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 (Player)
    }
  ]
}
Trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi games#playerListResponse cố định.
nextPageToken

string

Mã thông báo tương ứng với trang kết quả tiếp theo.
items[]

object (Player)

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.