Applications: listHidden

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ọ.
items[].hiddenTimeMillis long Thời gian ẩn trình phát này.