Applications: listHidden

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.
items[].hiddenTimeMillis long Thời gian người chơi này bị ẩn.