Method: scores.get

รับคะแนนสูงสุดและจัดอันดับ (ไม่บังคับ) ในลีดเดอร์บอร์ดสำหรับผู้เล่นที่ตรวจสอบสิทธิ์อยู่ในปัจจุบัน สำหรับช่วงเวลาที่เฉพาะเจาะจง คุณสามารถตั้งค่า leaderboardId เป็น ALL เพื่อดึงข้อมูลของลีดเดอร์บอร์ดทั้งหมดในช่วงเวลาที่กำหนด "หมายเหตุ: คุณไม่สามารถขอลีดเดอร์บอร์ด "ทั้งหมด" และช่วงเวลา "ทั้งหมด" ในคำขอเดียวกัน เนื่องจากสามารถตั้งค่าพารามิเตอร์เป็น "ทั้งหมด" ได้เพียงพารามิเตอร์เดียวเท่านั้น

คำขอ HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}

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

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

string

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

string

รหัสของลีดเดอร์บอร์ด สามารถตั้งค่าเป็น "ทั้งหมด" เพื่อดึงข้อมูลลีดเดอร์บอร์ดทั้งหมดสำหรับแอปพลิเคชันนี้
timeSpan

enum (ScoreTimeSpan)

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

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

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

string

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

enum (IncludeRankType)

ประเภทของอันดับที่จะแสดงผล หากละเว้นพารามิเตอร์ จะไม่มีการแสดงอันดับ
maxResults

integer

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

string

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

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

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

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

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

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

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

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

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

ScoreTimeSpan

ระบุระยะเวลาที่อาจเป็นไปได้สำหรับการให้คะแนน

Enum
ALL รับคะแนนสูงสุดในทุกช่วงเวลา หากใช้ตัวเลือกนี้ ระบบจะไม่สนใจค่า maxResults
ALL_TIME ทำคะแนนสูงสุดตลอดกาล
WEEKLY แสดงรายการคะแนนสูงสุดของวันปัจจุบัน
DAILY แสดงรายการคะแนนสูงสุดของสัปดาห์ปัจจุบัน

IncludeRankType

ค่าที่เป็นไปได้สำหรับประเภทอันดับ

Enum
ALL ดึงข้อมูลอันดับที่รองรับทั้งหมด ใน HTTP คุณระบุค่าพารามิเตอร์นี้เป็น ALL ได้ด้วย
PUBLIC เรียกข้อมูลอันดับแบบสาธารณะหากผู้เล่นแชร์กิจกรรมการเล่นเกมแบบสาธารณะ
SOCIAL

(ล้าสมัย) ดึงข้อมูลอันดับทางสังคม
FRIENDS ดึงข้อมูลอันดับในคอลเล็กชันเพื่อน