ต้องมีการให้สิทธิ์
ดึงรายชื่อโปรแกรมเล่นที่ซ่อนจากแอปพลิเคชันที่ระบุ วิธีการนี้ใช้ได้เฉพาะกับบัญชีผู้ใช้สำหรับแผงควบคุมสำหรับนักพัฒนาซอฟต์แวร์ของคุณเท่านั้น
ส่งคำขอ
คำขอ 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 } ] }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
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 เกมของผู้เล่น | |
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 |
ชื่อของผู้เล่นจะเป็นรางวัลสำหรับกิจกรรมของเกม |