REST Resource: players

Tài nguyên: Người chơi

Tài nguyên Trình phát.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "playerId": string,
  "displayName": string,
  "avatarImageUrl": string,
  "bannerUrlPortrait": string,
  "bannerUrlLandscape": string,
  "originalPlayerId": string,
  "profileSettings": {
    object (ProfileSettings)
  },
  "name": {
    "familyName": string,
    "givenName": string
  },
  "experienceInfo": {
    object (PlayerExperienceInfo)
  },
  "title": string,
  "friendStatus": enum (FriendStatus),
  "gamePlayerId": string
}
Các 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 cố định games#player
playerId

string

Mã nhận dạng của người chơi.
displayName

string

Tên hiển thị cho trình phát.
avatarImageUrl

string

URL cơ sở cho hình ảnh đại diện cho trình phát.
bannerUrlPortrait

string

URL đến ảnh biểu ngữ của trình phát ở chế độ dọc.
bannerUrlLandscape

string

URL đến ảnh biểu ngữ của trình phát ở chế độ ngang.
originalPlayerId

string

Mã nhận dạng người chơi được dùng cho người chơi này trong lần đầu tiên họ đăng nhập vào trò chơi có liên quan. Mã này chỉ được điền sẵn cho các lệnh gọi đến Player.get cho trình phát yêu cầu, chỉ khi mã nhận dạng người chơi sau đó thay đổi, và chỉ cho các ứng dụng hỗ trợ tính năng ánh xạ lại mã nhận dạng người chơi.
profileSettings

object (ProfileSettings)

Chế độ cài đặt hồ sơ của người chơi. Kiểm soát việc có hiển thị hồ sơ của người chơi với những người chơi khác hay không.
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.
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ọ.
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.
experienceInfo

object (PlayerExperienceInfo)

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.
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.
friendStatus

enum (FriendStatus)

Trạng thái bạn bè của người chơi đã cho, so với người yêu cầu. Chế độ này sẽ không được thiết lập nếu người chơi không chia sẻ danh sách bạn bè của họ với trò chơi đó.
gamePlayerId

string

Giá trị nhận dạng người chơi duy nhất cho mỗi ứng dụng.

ProfileSettings

Cài đặt hồ sơ

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
Các 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 cố định games#profileSettings.
profileVisible

boolean

Liệu hồ sơ của người chơi có hiển thị với người chơi hiện đang đăng nhập hay không.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

Liệu danh sách bạn bè của người chơi có hiển thị với trò chơi này hay không hoặc có thể yêu cầu được không. Trường này chỉ được điền sẵn cho người chơi hiện đang đăng nhập.

Enum
VISIBLE Danh sách bạn bè hiện đang hiển thị với trò chơi.
REQUEST_REQUIRED Nhà phát triển không có quyền truy cập vào danh sách bạn bè nhưng có thể gọi API Android để hiển thị hộp thoại đồng ý.
UNAVAILABLE Danh sách bạn bè hiện không khả dụng đối với người dùng này và không thể yêu cầu quyền truy cập tại thời điểm này, do người dùng đã vĩnh viễn từ chối hoặc tính năng bạn bè của họ không hoạt động. Ở trạng thái này, mọi nỗ lực yêu cầu quyền truy cập vào danh sách bạn bè sẽ không thành công.

PlayerExperienceInfo

Siêu dữ liệu của bên thứ nhất/bên thứ ba về trải nghiệm của người chơi.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
Các 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 cố định games#playerExperienceInfo.
currentExperiencePoints

string (int64 format)

Số điểm kinh nghiệm hiện tại của người chơi.
lastLevelUpTimestampMillis

string (int64 format)

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).
currentLevel

object (PlayerLevel)

Cấp độ hiện tại của người chơi.
nextLevel

object (PlayerLevel)

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.

PlayerLevel

Siêu dữ liệu của bên thứ nhất/bên thứ ba về cấp độ của người dùng.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
Các 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 cố định games#playerLevel.
level

integer

Cấp độ của người dùng.
minExperiencePoints

string (int64 format)

Điểm kinh nghiệm tối thiểu để đạt được cấp độ này.
maxExperiencePoints

string (int64 format)

Điểm kinh nghiệm tối đa cho cấp này.

FriendStatus

Xác định mối quan hệ bạn bè giữa những người chơi.

Enum
NO_RELATIONSHIP Không có mối quan hệ với nhau giữa những người chơi.
FRIEND Người chơi và người yêu cầu là bạn bè.

Phương thức

get

 Truy xuất tài nguyên Trình phát bằng mã nhận dạng cho trước.

getMultipleApplicationPlayerIds

 Lấy mã nhận dạng người chơi ứng dụng cho người chơi hiện đã được xác thực trên tất cả các trò chơi được yêu cầu bởi cùng một nhà phát triển giống như ứng dụng gọi.

getScopedPlayerIds

 Truy xuất giá trị nhận dạng người chơi trong phạm vi cho người dùng hiện đã xác thực.

list

 Nhận bộ sưu tập người chơi cho người dùng hiện đã được xác thực.