REST Resource: players

ทรัพยากร: ผู้เล่น

ทรัพยากรของโปรแกรมเล่น

การแสดง 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
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ games#player เสมอ
playerId

string

รหัสของโปรแกรมเล่น
displayName

string

ชื่อที่จะแสดงสำหรับโปรแกรมเล่น
avatarImageUrl

string

URL ฐานสำหรับรูปภาพที่แสดงถึงโปรแกรมเล่น
bannerUrlPortrait

string

URL ไปยังรูปภาพแบนเนอร์ของโปรแกรมเล่นในโหมดแนวตั้ง
bannerUrlLandscape

string

URL ไปยังรูปภาพแบนเนอร์ของโปรแกรมเล่นในโหมดแนวนอน
originalPlayerId

string

รหัสผู้เล่นที่ใช้สำหรับผู้เล่นรายนี้ในครั้งแรกที่พวกเขาลงชื่อเข้าใช้เกมที่เป็นปัญหา ค่านี้จะแสดงก็ต่อเมื่อมีการเรียก Player.get สำหรับโปรแกรมเล่นที่ส่งคำขอ ต่อเมื่อมีการเปลี่ยนรหัสโปรแกรมเล่นในภายหลัง และจะเกิดขึ้นเฉพาะกับไคลเอ็นต์ที่รองรับรหัสผู้เล่นที่แมปใหม่เท่านั้น
profileSettings

object (ProfileSettings)

การตั้งค่าโปรไฟล์ของผู้เล่น ควบคุมว่าจะแสดงโปรไฟล์ของผู้เล่นคนอื่นๆ หรือไม่
name

object

ตัวแทนออบเจ็กต์ของคอมโพเนนต์แต่ละรายการของชื่อผู้เล่น สำหรับผู้เล่นบางคน ช่องเหล่านี้อาจไม่มีอยู่
name.familyName

string

นามสกุลของผู้เล่นรายนี้ ในบางแห่ง อาจเรียกว่านามสกุล
name.givenName

string

ชื่อจริงของผู้เล่นนี้ ในบางแห่ง อาจเรียกว่าชื่อจริง
experienceInfo

object (PlayerExperienceInfo)

ออบเจ็กต์ที่แสดงข้อมูลประสบการณ์ Play Games ของผู้เล่น
title

string

ชื่อของผู้เล่นได้รับรางวัลจากกิจกรรมเกม
friendStatus

enum (FriendStatus)

สถานะเพื่อนของผู้เล่นที่ระบุสัมพันธ์กับผู้ขอ ระบบจะยกเลิกการตั้งค่านี้หากผู้เล่นไม่ได้แชร์รายชื่อเพื่อนกับเกม
gamePlayerId

string

ตัวระบุโปรแกรมเล่นที่ไม่ซ้ำกันสำหรับแต่ละแอปพลิเคชัน

ProfileSettings

การตั้งค่าโปรไฟล์

การแสดง JSON 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ games#profileSettings เสมอ
profileVisible

boolean

โปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในปัจจุบันจะเห็นโปรไฟล์ของผู้เล่นหรือไม่
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

รายชื่อเพื่อนของผู้เล่นจะเห็นในเกมนี้หรือขอได้ ช่องนี้จะมีข้อมูลสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในปัจจุบันเท่านั้น

Enum
VISIBLE รายชื่อเพื่อนจะปรากฏให้เห็นในเกม
REQUEST_REQUIRED นักพัฒนาซอฟต์แวร์ไม่มีสิทธิ์เข้าถึงรายชื่อเพื่อน แต่เรียกใช้ Android API เพื่อแสดงกล่องโต้ตอบความยินยอมได้
UNAVAILABLE ขณะนี้ รายชื่อเพื่อนไม่สามารถใช้ได้สำหรับผู้ใช้รายนี้ และไม่สามารถขอสิทธิ์การเข้าถึงได้ในขณะนี้ เนื่องจากผู้ใช้ได้ปฏิเสธอย่างถาวรแล้ว หรือพวกเขาไม่สามารถใช้งานคุณลักษณะเพื่อนได้ ในสถานะนี้ ความพยายามขอเข้าถึงรายชื่อเพื่อนจะไม่ประสบความสำเร็จ

PlayerExperienceInfo

ข้อมูลเมตาของบุคคลที่หนึ่ง/บุคคลที่สามเกี่ยวกับประสบการณ์ของผู้เล่น

การแสดง JSON 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ games#playerExperienceInfo เสมอ
currentExperiencePoints

string (int64 format)

จำนวนคะแนนประสบการณ์ปัจจุบันของผู้เล่น
lastLevelUpTimestampMillis

string (int64 format)

การประทับเวลาเมื่อผู้เล่นเลื่อนระดับเป็นมิลลิวินาทีตั้งแต่ Unix Epoch UTC
currentLevel

object (PlayerLevel)

ระดับปัจจุบันของโปรแกรมเล่น
nextLevel

object (PlayerLevel)

ระดับถัดไปของผู้เล่น หากระดับปัจจุบันเป็นระดับสูงสุด ควรเท่ากับระดับปัจจุบัน

PlayerLevel

ข้อมูลเมตาของบุคคลที่หนึ่ง/บุคคลที่สามเกี่ยวกับระดับของผู้ใช้

การแสดง JSON 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ games#playerLevel เสมอ
level

integer

ระดับสำหรับผู้ใช้
minExperiencePoints

string (int64 format)

คะแนนประสบการณ์ขั้นต่ำสำหรับระดับนี้
maxExperiencePoints

string (int64 format)

คะแนนประสบการณ์สูงสุดสำหรับระดับนี้

FriendStatus

กำหนดความสัมพันธ์แห่งมิตรภาพระหว่างผู้เล่น

Enum
NO_RELATIONSHIP ผู้เล่นไม่ได้มีความสัมพันธ์กัน
FRIEND ผู้เล่นและผู้ส่งคำขอเป็นเพื่อนกัน

วิธีการ

get

 เรียกข้อมูลทรัพยากรโปรแกรมเล่นด้วยรหัสที่กำหนด

getMultipleApplicationPlayerIds

 รับรหัสโปรแกรมเล่นของแอปพลิเคชันสำหรับโปรแกรมเล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบันสำหรับเกมที่ขอทั้งหมดโดยนักพัฒนาซอฟต์แวร์รายเดียวกันกับแอปพลิเคชันการโทร

getScopedPlayerIds

 เรียกข้อมูลตัวระบุโปรแกรมเล่นที่กำหนดขอบเขตสำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน

list

 รับคอลเล็กชันโปรแกรมเล่นสำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน