Cần phải uỷ quyền
Lấy danh sách người chơi bị ẩn khỏi ứng dụng cụ thể. Phương thức này chỉ khả dụng với tài khoản người dùng có trong bảng điều khiển dành cho nhà phát triển của bạn.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
Tham số
Tên thông số | Giá trị | Mô tả |
---|---|---|
Tham số đường dẫn | ||
applicationId |
string |
Mã ứng dụng trên Google Play Console. |
Tham số truy vấn không bắt buộc | ||
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.
Giá trị có thể chấp nhận là từ 1 đến 15 .
|
pageToken |
string |
Mã thông báo do yêu cầu trước đó trả về. |
Ủy quyền
Yêu cầu này cần có sự cho phép có phạm vi sau (đọc thêm về quy trình xác thực và uỷ quyền).
Phạm vi |
---|
https://www.googleapis.com/auth/games |
Nội dung yêu cầu
Đừng cung cấp nội dung yêu cầu bằng phương thức này.
Phản hồi
Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
Tên tài sản | Giá trị | Mô tả | Ghi chú |
---|---|---|---|
kind |
string |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi gamesManagement#hiddenPlayerList cố định. |
|
nextPageToken |
string |
Mã phân trang cho trang kết quả tiếp theo. | |
items[] |
list |
Người chơi. | |
items[].kind |
string |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi gamesManagement#hiddenPlayer cố định. |
|
items[].player |
nested object |
Thông tin về người chơi. | |
items[].player.kind |
string |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi gamesManagement#player cố định. |
|
items[].player.playerId |
string |
Mã nhận dạng của trình phát. | |
items[].player.displayName |
string |
Tên hiển thị cho người chơi. | |
items[].player.avatarImageUrl |
string |
URL cơ sở của hình ảnh đại diện cho trình phát. | |
items[].player.lastPlayedWith |
nested object |
Thông tin chi tiết về lần gần nhất người chơi này chơi trò chơi nhiều người chơi với người chơi hiện đã xác thực. Được điền sẵn cho các thành viên trong bộ sưu tập người chơi PLAYED_WITH. | |
items[].player.lastPlayedWith.timeMillis |
long |
Lần gần đây nhất mà người chơi chơi trò chơi tính bằng mili giây kể từ thời gian bắt đầu của hệ thống theo giờ UTC. | |
items[].player.lastPlayedWith.autoMatched |
boolean |
Đúng nếu trình phát được tự động so khớp với người dùng đang được xác thực. | |
items[].player.name |
object |
Một đối tượng đại diện cho các thành phần riêng lẻ trong tên người chơi. Một số người chơi có thể không thấy các trường này. | |
items[].player.name.familyName |
string |
Họ của người chơi này. Ở một số nơi, đây được gọi là họ. | |
items[].player.name.givenName |
string |
Tên của người chơi này. Ở một số nơi, đây được gọi là tên. | |
items[].player.experienceInfo |
nested object |
Đối tượng để biểu thị thông tin về trải nghiệm của người chơi trên Play Trò chơi. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
Số điểm kinh nghiệm hiện tại của người chơi. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
Dấu thời gian khi người chơi được lên cấp, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống Unix (giờ UTC). | |
items[].player.experienceInfo.currentLevel |
nested object |
Cấp độ hiện tại của người chơi. | |
items[].player.experienceInfo.currentLevel.level |
integer |
Cấp độ cho người dùng. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
Điểm kinh nghiệm tối thiểu cho cấp độ này. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
Số điểm kinh nghiệm tối đa cho cấp độ này. | |
items[].player.experienceInfo.nextLevel |
nested object |
Cấp độ tiếp theo của người chơi. Nếu cấp hiện tại là cấp tối đa, thì cấp này phải giống với cấp hiện tại. | |
items[].player.experienceInfo.nextLevel.level |
integer |
Cấp độ cho người dùng. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
Điểm kinh nghiệm tối thiểu cho cấp độ này. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
Số điểm kinh nghiệm tối đa cho cấp độ này. | |
items[].player.title |
string |
Danh hiệu của người chơi được đền đáp cho các hoạt động trong trò chơi của họ. |