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: 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: แอปพลิเคชัน

วิธีการ
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}
เรียกข้อมูลทรัพยากรของโปรแกรมเล่นด้วยรหัสที่ระบุ
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
รับรหัสโปรแกรมเล่นของแอปพลิเคชันสำหรับโปรแกรมเล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบันสำหรับเกมที่ขอทั้งหมดโดยนักพัฒนาซอฟต์แวร์รายเดียวกันกับแอปพลิเคชันการโทร
getScopedPlayerIds GET /games/v1/players/me/scopedIds
เรียกข้อมูลตัวระบุโปรแกรมเล่นที่กำหนดขอบเขตสำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน
list GET /games/v1/players/me/players/{collection}
รับคอลเล็กชันโปรแกรมเล่นสำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน

ทรัพยากร REST: recall

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

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

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

ทรัพยากร REST: คะแนน

วิธีการ
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
แสดงผลสถิติการมีส่วนร่วมและการใช้จ่ายในแอปพลิเคชันนี้สำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน