บริการเกมของ Google Play ช่วยให้นักพัฒนาซอฟต์แวร์ปรับปรุงเกมด้วยลีดเดอร์บอร์ดโซเชียล รางวัลพิเศษ สถานะของเกม การลงชื่อเข้าใช้ด้วย Google และอื่นๆ
- ทรัพยากร REST: Accesstokens
- ทรัพยากร REST: achievementDefinitions
- แหล่งข้อมูล REST: รางวัลพิเศษ
- ทรัพยากร REST: แอปพลิเคชัน
- ทรัพยากร REST: เหตุการณ์
- แหล่งข้อมูล REST: ลีดเดอร์บอร์ด
- แหล่งข้อมูล REST: Metagame
- ทรัพยากร REST: ผู้เล่น
- ทรัพยากร REST: การเรียกคืน
- ทรัพยากร REST: การแก้ไข
- แหล่งข้อมูล REST: คะแนน
- ทรัพยากร REST: สแนปชอต
- แหล่งข้อมูล REST: สถิติ
บริการ: 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 แสดงสถิติการมีส่วนร่วมและการใช้จ่ายในแอปพลิเคชันนี้สำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน |