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