ต้องมีการให้สิทธิ์
ดูรายการผู้เล่นที่ซ่อนไว้จากแอปพลิเคชันที่ระบุ วิธีนี้ใช้ได้เฉพาะกับบัญชีผู้ใช้ของ Developer Console เท่านั้น
ส่งคำขอ
คำขอ HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
พารามิเตอร์
ชื่อพารามิเตอร์ | ค่า | คำอธิบาย |
---|---|---|
พารามิเตอร์เส้นทาง | ||
applicationId |
string |
รหัสแอปพลิเคชันจาก Google Play Console |
พารามิเตอร์การค้นหาที่ไม่บังคับ | ||
maxResults |
integer |
จำนวนสูงสุดของทรัพยากรโปรแกรมเล่นที่จะแสดงผลในการตอบสนอง ใช้สำหรับการแบ่งหน้า สำหรับการตอบกลับใดๆ จำนวนทรัพยากรของผู้เล่นจริงที่ส่งคืนอาจน้อยกว่า maxResults ที่ระบุไว้
ค่าที่ยอมรับได้คือ 1 ถึง 15 เท่านั้น
|
pageToken |
string |
โทเค็นที่แสดงผลโดยคำขอก่อนหน้า |
การให้สิทธิ์
คำขอนี้ต้องได้รับสิทธิ์ด้วยขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
ขอบเขต |
---|
https://www.googleapis.com/auth/games |
เนื้อหาของคำขอ
โปรดอย่าแสดงเนื้อหาของคำขอด้วยวิธีนี้
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบสนองที่มีโครงสร้างต่อไปนี้
{ "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 } ] }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
kind |
string |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ gamesManagement#hiddenPlayerList เสมอ |
|
nextPageToken |
string |
โทเค็นการแบ่งหน้าสำหรับหน้าผลการค้นหาถัดไป | |
items[] |
list |
ผู้เล่น | |
items[].kind |
string |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ gamesManagement#hiddenPlayer เสมอ |
|
items[].player |
nested object |
ข้อมูลผู้เล่น | |
items[].player.kind |
string |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ gamesManagement#player เสมอ |
|
items[].player.playerId |
string |
รหัสของโปรแกรมเล่น | |
items[].player.displayName |
string |
ชื่อที่จะแสดงสำหรับโปรแกรมเล่น | |
items[].player.avatarImageUrl |
string |
URL ฐานสำหรับรูปภาพที่แสดงถึงโปรแกรมเล่น | |
items[].player.lastPlayedWith |
nested object |
รายละเอียดเกี่ยวกับเวลาล่าสุดที่ผู้เล่นรายนี้เล่นเกมแบบผู้เล่นหลายคนด้วยโปรแกรมเล่นที่ตรวจสอบสิทธิ์อยู่ในขณะนี้ ป้อนข้อมูลสำหรับสมาชิกคอลเล็กชันผู้เล่นของ PLAYED_WITH แล้ว | |
items[].player.lastPlayedWith.timeMillis |
long |
เวลาล่าสุดที่ผู้เล่นเล่นเกมเป็นมิลลิวินาทีตั้งแต่ Epoch ใน UTC | |
items[].player.lastPlayedWith.autoMatched |
boolean |
เป็นจริงหากจับคู่โปรแกรมเล่นโดยอัตโนมัติกับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน | |
items[].player.name |
object |
ตัวแทนออบเจ็กต์ของคอมโพเนนต์แต่ละรายการของชื่อผู้เล่น สำหรับผู้เล่นบางคน ช่องเหล่านี้อาจไม่มีอยู่ | |
items[].player.name.familyName |
string |
นามสกุลของผู้เล่นรายนี้ ในบางแห่ง อาจเรียกว่านามสกุล | |
items[].player.name.givenName |
string |
ชื่อจริงของผู้เล่นนี้ ในบางแห่ง อาจเรียกว่าชื่อจริง | |
items[].player.experienceInfo |
nested object |
ออบเจ็กต์ที่แสดงข้อมูลประสบการณ์ Play Games ของผู้เล่น | |
items[].player.experienceInfo.currentExperiencePoints |
long |
จำนวนคะแนนประสบการณ์ปัจจุบันของผู้เล่น | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
การประทับเวลาเมื่อผู้เล่นเลื่อนระดับเป็นมิลลิวินาทีตั้งแต่ Unix Epoch UTC | |
items[].player.experienceInfo.currentLevel |
nested object |
ระดับปัจจุบันของโปรแกรมเล่น | |
items[].player.experienceInfo.currentLevel.level |
integer |
ระดับสำหรับผู้ใช้ | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
คะแนนประสบการณ์ขั้นต่ำสำหรับระดับนี้ | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
คะแนนประสบการณ์สูงสุดสำหรับระดับนี้ | |
items[].player.experienceInfo.nextLevel |
nested object |
ระดับถัดไปของผู้เล่น หากระดับปัจจุบันเป็นระดับสูงสุด ควรเท่ากับระดับปัจจุบัน | |
items[].player.experienceInfo.nextLevel.level |
integer |
ระดับสำหรับผู้ใช้ | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
คะแนนประสบการณ์ขั้นต่ำสำหรับระดับนี้ | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
คะแนนประสบการณ์สูงสุดสำหรับระดับนี้ | |
items[].player.title |
string |
ชื่อของผู้เล่นได้รับรางวัลจากกิจกรรมเกม |