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 เกมของผู้เล่น
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

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

การแสดง 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

 ดึงทรัพยากรของ Player ด้วยรหัสที่กำหนด

getMultipleApplicationPlayerIds

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

getScopedPlayerIds

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

list

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