REST Resource: players

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

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

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
}
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 trình phát.
displayName

string

Tên hiển thị cho người chơi.
avatarImageUrl

string

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

string

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

string

URL dẫn đến hình ả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 vào lần đầu tiên họ đăng nhập vào trò chơi liên quan. Mã này chỉ được điền sẵn cho các lệnh gọi đến Player.get cho người chơi yêu cầu, chỉ khi mã nhận dạng người chơi sau đó đã thay đổi và chỉ được điền cho các ứng dụng khách hỗ trợ gán 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 hồ sơ của người chơi có hiển thị 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. Một số người chơi có thể không thấy các trường này.
name.familyName

string

Họ của người chơi này. Ở một số nơi, đâ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.
experienceInfo

object (PlayerExperienceInfo)

Đố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.
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ọ.
friendStatus

enum (FriendStatus)

Trạng thái bạn bè của người chơi cụ thể, liên quan đến người yêu cầu. Chính sách này sẽ không được đặt 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)
}
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 games#profileSettings cố định.
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ể được yêu cầu hay 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 Hiện tại, trò chơi có thể nhìn thấy danh sách bạn bè.
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 để cho thấy 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 vào thời điểm này, bởi vì người dùng đã từ chối vĩnh viễn hoặc tính năng bạn bè không khả dụng đối với họ. Ở 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è đều 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)
  }
}
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 games#playerExperienceInfo cố định.
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 (giờ 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 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
}
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 games#playerLevel cố định.
level

integer

Cấp độ cho người dùng.
minExperiencePoints

string (int64 format)

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

string (int64 format)

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

FriendStatus

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

Enum
NO_RELATIONSHIP Không có mối quan hệ nào 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.

getMultipleApplicationPlayerIds

 Lấy mã trình phát ứng dụng của 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 dưới dạng ứng dụng gọi.

getScopedPlayerIds

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

list

 Lấy tập hợp người chơi cho người dùng hiện đã được xác thực.