Cần có sự cho phép
Lấy danh sách người chơi ẩn khỏi ứng dụng cho trước. Phương thức này chỉ dành cho tài khoản người dùng trong Developer Console của bạn.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
Các tham số
Tên thông số | Giá trị | Nội dung mô tả |
---|---|---|
Tham số đường dẫn | ||
applicationId |
string |
Mã ứng dụng từ Google Play Console. |
Tham số truy vấn không bắt buộc | ||
maxResults |
integer |
Số tài nguyên người chơi tối đa cần trả về trong phản hồi, dùng để phân trang. Đối với mọi phản hồi, số lượng tài nguyên thực tế của người chơi được trả về có thể ít hơn maxResults được chỉ định.
Các giá trị được chấp nhận là từ 1 đến 15 .
|
pageToken |
string |
Mã thông báo được yêu cầu trước đó trả về. |
Ủy quyền
Yêu cầu này cần được uỷ quyền với 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ề một 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ị | Nội dung 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 cố định gamesManagement#hiddenPlayerList . |
|
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 cố định gamesManagement#hiddenPlayer . |
|
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 cố định gamesManagement#player . |
|
items[].player.playerId |
string |
Mã nhận dạng của người chơi. | |
items[].player.displayName |
string |
Tên hiển thị cho trình phát. | |
items[].player.avatarImageUrl |
string |
URL cơ sở cho 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 đây nhất mà 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 đã được xác thực. Được điền sẵn cho PLAY_WITH thành viên trong bộ sưu tập người chơi. | |
items[].player.lastPlayedWith.timeMillis |
long |
Lần gần đây nhất mà người chơi chơi trò chơi này 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 người chơi được tự động so khớp với người dùng hiện đã đượ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. Đối với một số người chơi, các trường này có thể không xuất hiện. | |
items[].player.name.familyName |
string |
Họ của người chơi này. Ở một số nơi, tên nà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 đầu tiên. | |
items[].player.experienceInfo |
nested object |
Một đối tượng thể hiện 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 (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 độ của người dùng. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
Điểm kinh nghiệm tối thiểu để đạt được cấp độ này. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
Đ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 độ của người dùng. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
Điểm kinh nghiệm tối thiểu để đạt được cấp độ này. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
Đ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 tặng thưởng cho các hoạt động của họ trong trò chơi. |