- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ScoreTimeSpan
- IncludeRankType
- ลองใช้งาน
รับคะแนนสูงสุดและจัดอันดับ (ไม่บังคับ) ในลีดเดอร์บอร์ดสำหรับผู้เล่นที่ตรวจสอบสิทธิ์อยู่ในปัจจุบัน สำหรับช่วงเวลาที่เฉพาะเจาะจง คุณสามารถตั้งค่า leaderboardId
เป็น ALL
เพื่อดึงข้อมูลของลีดเดอร์บอร์ดทั้งหมดในช่วงเวลาที่กำหนด "หมายเหตุ: คุณไม่สามารถขอลีดเดอร์บอร์ด "ทั้งหมด" และช่วงเวลา "ทั้งหมด" ในคำขอเดียวกัน เนื่องจากสามารถตั้งค่าพารามิเตอร์เป็น "ทั้งหมด" ได้เพียงพารามิเตอร์เดียวเท่านั้น
คำขอ HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
playerId |
รหัสผู้เล่น ระบบอาจใช้ค่า |
leaderboardId |
รหัสของลีดเดอร์บอร์ด สามารถตั้งค่าเป็น "ทั้งหมด" เพื่อดึงข้อมูลลีดเดอร์บอร์ดทั้งหมดสำหรับแอปพลิเคชันนี้ |
timeSpan |
ช่วงเวลาสำหรับคะแนนและอันดับที่คุณขอ |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
language |
ภาษาที่ต้องการใช้สำหรับสตริงที่แสดงผลโดยวิธีนี้ |
includeRankType |
ประเภทของอันดับที่จะแสดงผล หากละเว้นพารามิเตอร์ จะไม่มีการแสดงอันดับ |
maxResults |
จำนวนคะแนนลีดเดอร์บอร์ดสูงสุดที่จะแสดงในการตอบกลับ สำหรับการตอบกลับใดๆ จำนวนคะแนนลีดเดอร์บอร์ดที่แสดงผลจริงอาจน้อยกว่า |
pageToken |
โทเค็นที่แสดงผลโดยคำขอก่อนหน้า |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ 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 |
ดึงข้อมูลอันดับในคอลเล็กชันเพื่อน |