Method: scores.listWindow

แสดงคะแนนในลีดเดอร์บอร์ดรอบๆ (และรวม) คะแนนของผู้เล่น

คำขอ HTTP

GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}

พารามิเตอร์เส้นทาง

พารามิเตอร์
leaderboardId

string

รหัสของลีดเดอร์บอร์ด

collection

enum (ScoreCollection)

การรวบรวมคะแนนที่คุณขอรับ

พารามิเตอร์การค้นหา

พารามิเตอร์
language

string

ภาษาที่ต้องการใช้สำหรับสตริงที่แสดงผลโดยวิธีนี้

timeSpan

enum (ScoreTimeSpan)

ต้องระบุ ช่วงเวลาสำหรับคะแนนและอันดับที่คุณขอ

maxResults

integer

จำนวนคะแนนลีดเดอร์บอร์ดสูงสุดที่จะแสดงในการตอบกลับ สำหรับการตอบกลับใดๆ จำนวนคะแนนลีดเดอร์บอร์ดที่แสดงผลจริงอาจน้อยกว่า maxResults ที่ระบุไว้

resultsAbove

integer

จำนวนคะแนนที่ต้องการให้แสดงสูงกว่าคะแนนของผู้เล่น อาจแสดงผลคะแนนมากขึ้นหากผู้เล่นอยู่ด้านล่างของลีดเดอร์บอร์ด ผู้เล่นอาจแสดงผลคะแนนน้อยลงหากผู้เล่นอยู่ด้านบนสุด ต้องน้อยกว่าหรือเท่ากับ maxResults

returnTopIfAbsent

boolean

เป็นจริงหากควรแสดงคะแนนสูงสุดเมื่อผู้เล่นไม่ได้อยู่ในลีดเดอร์บอร์ด ค่าเริ่มต้นคือ true

pageToken

string

โทเค็นที่แสดงผลโดยคำขอก่อนหน้า

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ListLeaderboardScoresResponse

ขอบเขตการให้สิทธิ์

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0