Google Play Game Services

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

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

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

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

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

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

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

  • https://games.googleapis.com

ทรัพยากร REST: accesstokens

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

ทรัพยากร REST: achievementDefinitions

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

ทรัพยากร REST: รางวัลพิเศษ

เมธอด
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: ลีดเดอร์บอร์ด

เมธอด
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: ผู้เล่น

เมธอด
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: การเรียกคืน

เมธอด
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
เรียกโทเค็น Recall จากเกมที่ขอทั้งหมดซึ่งเชื่อมโยงกับเพลเยอร์ PGS ที่เข้ารหัสในรหัสเซสชันการเรียกคืนที่ระบุ
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
เรียกโทเค็น Recall ล่าสุดจากเกมของนักพัฒนาซอฟต์แวร์ทั้งหมดที่เชื่อมโยงกับโปรแกรมเล่น 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
ลบโทเค็น Recall ที่เชื่อมโยงผู้ใช้หลักของโปรแกรมเล่น PGS ที่ระบุโดยเซสชัน Recall กับบัญชีในเกมที่ระบุด้วย "ลักษณะตัวตน" หรือค่าโทเค็น

ทรัพยากร REST: การแก้ไข

เมธอด
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: สแนปชอต

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

ทรัพยากร REST: สถิติ

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