Google Play Games Services API

บริการเกมของ Google Play ช่วยให้นักพัฒนาแอปปรับปรุงเกมด้วยลีดเดอร์บอร์ดโซเชียล รางวัลพิเศษ สถานะเกม การลงชื่อเข้าใช้ด้วย Google และอื่นๆ ได้

บริการ: games.googleapis.com

หากต้องการเรียกใช้บริการนี้ เราขอแนะนำให้คุณใช้ไลบรารีของไคลเอ็นต์ที่ Google จัดหาให้ หากแอปพลิเคชันของคุณต้องใช้ไลบรารีของคุณเองเพื่อเรียกใช้บริการนี้ ให้ใช้ข้อมูลต่อไปนี้เมื่อส่งคำขอ API

เอกสารการค้นพบ

เอกสารการค้นหาเป็นข้อกำหนดที่เครื่องอ่านได้สำหรับการอธิบายและการใช้ REST API โดยใช้เพื่อสร้างไลบรารีของไคลเอ็นต์ ปลั๊กอิน IDE และเครื่องมืออื่นๆ ที่โต้ตอบกับ Google API บริการหนึ่งๆ อาจมีเอกสารการค้นหาหลายรายการ บริการนี้มีเอกสารการค้นพบต่อไปนี้

ปลายทางบริการ

ปลายทางบริการคือ URL ฐานที่ระบุที่อยู่เครือข่ายของบริการ API บริการหนึ่งๆ อาจมีปลายทางบริการหลายรายการ บริการนี้มีปลายทางของบริการต่อไปนี้ และ URI ทั้งหมดด้านล่างจะเกี่ยวข้องกับปลายทางของบริการนี้

  • https://games.googleapis.com

ทรัพยากร REST: accesstokens

เมธอด
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
สร้างโทเค็น Play Grouping API สำหรับผู้ใช้ PGS ที่ระบุโดยข้อมูลเข้าสู่ระบบที่แนบมา
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
สร้างโทเค็น Play Grouping API สำหรับผู้ใช้ PGS ที่ระบุโดยรหัสเซสชันการเรียกคืนที่ระบุในคำขอ

ทรัพยากร REST: achievementDefinitions

เมธอด
list GET /games/v1/achievements
แสดงคำจำกัดความของความสำเร็จทั้งหมดสำหรับแอปพลิเคชันของคุณ

ทรัพยากร REST: achievements

เมธอด
increment POST /games/v1/achievements/{achievementId}/increment
เพิ่มจำนวนก้าวของความสำเร็จที่มีรหัสที่ระบุสำหรับผู้เล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบัน
list GET /games/v1/players/{playerId}/achievements
แสดงความคืบหน้าของความสำเร็จทั้งหมดของแอปพลิเคชันสำหรับผู้เล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบัน
reveal POST /games/v1/achievements/{achievementId}/reveal
ตั้งค่าสถานะของความสำเร็จที่มีรหัสที่ระบุเป็น REVEALED สำหรับผู้เล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบัน
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
กำหนดจำนวนก้าวสำหรับผู้เล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบันเพื่อปลดล็อกรางวัลพิเศษ
unlock POST /games/v1/achievements/{achievementId}/unlock
ปลดล็อกรางวัลพิเศษนี้สำหรับผู้เล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบัน
updateMultiple POST /games/v1/achievements/updateMultiple
อัปเดตความสำเร็จหลายรายการสำหรับผู้เล่นที่ตรวจสอบสิทธิ์ในปัจจุบัน

ทรัพยากร REST: applications

เมธอด
get GET /games/v1/applications/{applicationId}
เรียกข้อมูลเมตาของแอปพลิเคชันที่มีรหัสที่ระบุ
getEndPoint POST /games/v1/applications/getEndPoint
แสดงผล URL สำหรับประเภทจุดสิ้นสุดที่ร้องขอ
played POST /games/v1/applications/played
ระบุว่าผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบันกำลังเล่นแอปพลิเคชันของคุณ
verify GET /games/v1/applications/{applicationId}/verify
ยืนยันว่าโทเค็นการให้สิทธิ์ที่ระบุในคำขอนี้เป็นของแอปพลิเคชันที่มีรหัสที่ระบุ และแสดงรหัสของเพลเยอร์ที่ได้รับสิทธิ์

ทรัพยากร REST: events

เมธอด
listByPlayer GET /games/v1/events
แสดงรายการที่แสดงความคืบหน้าปัจจุบันเกี่ยวกับเหตุการณ์ในแอปพลิเคชันนี้สำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน
listDefinitions GET /games/v1/eventDefinitions
แสดงรายการคำจำกัดความของเหตุการณ์ในแอปพลิเคชันนี้
record POST /games/v1/events
บันทึกการเปลี่ยนแปลงแบบกลุ่มในจำนวนครั้งที่เกิดเหตุการณ์สำหรับผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบันของแอปพลิเคชันนี้

ทรัพยากร REST: leaderboards

เมธอด
get GET /games/v1/leaderboards/{leaderboardId}
ดึงข้อมูลเมตาของลีดเดอร์บอร์ดที่มีรหัสที่ระบุ
list GET /games/v1/leaderboards
แสดงข้อมูลเมตาของลีดเดอร์บอร์ดทั้งหมดสำหรับแอปพลิเคชันของคุณ

ทรัพยากร REST: metagame

เมธอด
getMetagameConfig GET /games/v1/metagameConfig
แสดงผลข้อมูลการกำหนดค่าเมตาเกมสำหรับแอปพลิเคชันที่เรียกใช้
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
แสดงข้อมูลการเล่นที่รวบรวมตามหมวดหมู่สำหรับเพลเยอร์ที่สอดคล้องกับ playerId

ทรัพยากร REST: playerGameEvents

เมธอด
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
บันทึกกลุ่มเหตุการณ์ในเกมของผู้เล่นสำหรับผู้เล่นที่เฉพาะเจาะจง

ทรัพยากร REST: players

เมธอด
get GET /games/v1/players/{playerId}
เรียกข้อมูลทรัพยากร Player ที่มีรหัสที่ระบุ
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
รับรหัสผู้เล่นของแอปพลิเคชันสำหรับผู้เล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบันในเกมทั้งหมดที่นักพัฒนาแอปเดียวกันกับแอปพลิเคชันที่เรียกขอ
getScopedPlayerIds GET /games/v1/players/me/scopedIds
ดึงตัวระบุผู้เล่นที่กำหนดขอบเขตสำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน
list GET /games/v1/players/me/players/{collection}
รับคอลเล็กชันของผู้เล่นสำหรับผู้ใช้ปัจจุบันที่ตรวจสอบสิทธิ์แล้ว

ทรัพยากร REST: recall

เมธอด
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
ดึงโทเค็นเรียกคืนข้อมูลจากเกมที่ขอทั้งหมดซึ่งเชื่อมโยงกับผู้เล่น PGS ที่เข้ารหัสในรหัสเซสชันการเรียกคืนข้อมูลที่ระบุ
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
ดึงโทเค็นเรียกคืนข้อมูลล่าสุดจากเกมทั้งหมดของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับผู้เล่น PGS ที่เข้ารหัสในรหัสเซสชันการเรียกคืนข้อมูลที่ระบุ
linkPersona POST /games/v1/recall:linkPersona
เชื่อมโยงหลักของผู้เล่น PGS ที่เข้ารหัสในรหัสเซสชันการเรียกคืนข้อมูลที่ระบุกับบัญชีในเกม
resetPersona POST /games/v1/recall:resetPersona
ลบโทเค็น Recall ทั้งหมดที่ลิงก์ตัวตนที่ระบุกับผู้เล่น (มีหรือไม่มีโปรไฟล์ก็ได้)
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
ดึงโทเค็นเรียกคืนข้อมูลทั้งหมดที่เชื่อมโยงกับผู้เล่น PGS ที่เข้ารหัสในรหัสเซสชันการเรียกคืนข้อมูลที่ระบุ
unlinkPersona POST /games/v1/recall:unlinkPersona
ลบโทเค็นเรียกคืนข้อมูลที่ลิงก์หลักของผู้เล่น PGS ซึ่งระบุโดยเซสชัน Recall และบัญชีในเกมที่ระบุโดย 'ลักษณะตัวตน' หรือค่าโทเค็น

ทรัพยากร REST: revisions

เมธอด
check GET /games/v1/revisions/check
ตรวจสอบว่าไคลเอ็นต์เกมเป็นเวอร์ชันเก่าหรือไม่

ทรัพยากร REST: scores

เมธอด
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
รับคะแนนสูงสุดและอันดับ (ไม่บังคับ) ในลีดเดอร์บอร์ดสำหรับผู้เล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบัน
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
แสดงคะแนนในลีดเดอร์บอร์ดโดยเริ่มจากคะแนนสูงสุด
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
แสดงคะแนนในลีดเดอร์บอร์ดรอบๆ (และรวมถึง) คะแนนของผู้เล่น
submit POST /games/v1/leaderboards/{leaderboardId}/scores
ส่งคะแนนไปยังลีดเดอร์บอร์ดที่ระบุ
submitMultiple POST /games/v1/leaderboards/scores
ส่งคะแนนหลายรายการไปยังลีดเดอร์บอร์ด

ทรัพยากร REST: snapshots

เมธอด
get GET /games/v1/snapshots/{snapshotId}
ดึงข้อมูลเมตาสำหรับรหัสสแนปชอตที่ระบุ
list GET /games/v1/players/{playerId}/snapshots
ดึงข้อมูลรายการสแนปชอตที่แอปพลิเคชันของคุณสร้างขึ้นสำหรับผู้เล่นที่สอดคล้องกับรหัสผู้เล่น

ทรัพยากร REST: stats

เมธอด
get GET /games/v1/stats
แสดงสถิติความผูกพันและค่าใช้จ่ายในแอปพลิเคชันนี้สำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน