Dịch vụ trò chơi của Google Play cho phép nhà phát triển cải thiện trò chơi qua bảng xếp hạng xã hội, thành tích, trạng thái trò chơi, đăng nhập bằng Google và hơn thế nữa.
Dịch vụ: games.googleapis.com
Để gọi dịch vụ này, bạn nên sử dụng thư viện ứng dụng do Google cung cấp. Nếu ứng dụng cần sử dụng thư viện của riêng bạn để gọi dịch vụ này, hãy sử dụng thông tin sau khi bạn yêu cầu API.
Tài liệu khám phá
Discovery Document (Tài liệu khám phá) là quy cách mà máy có thể đọc được để mô tả và sử dụng các API REST. Thư viện này được dùng để tạo thư viện ứng dụng, trình bổ trợ IDE và các công cụ khác tương tác với API của Google. Một dịch vụ có thể cung cấp nhiều tài liệu khám phá. Dịch vụ này cung cấp tài liệu khám phá sau:
Điểm cuối dịch vụ
Điểm cuối của dịch vụ là một URL cơ sở chỉ định địa chỉ mạng của dịch vụ API. Một dịch vụ có thể có nhiều điểm cuối dịch vụ. Dịch vụ này có điểm cuối dịch vụ sau đây và tất cả các URI bên dưới đều liên quan đến điểm cuối dịch vụ này:
https://games.googleapis.com
Phương thức |
generatePlayGroupingApiToken |
POST /games/v1/accesstokens/generatePlayGroupingApiToken
Tạo mã thông báo API Play Grouping cho người dùng PGS được xác định bằng thông tin đăng nhập đính kèm. |
generateRecallPlayGroupingApiToken |
POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Tạo mã thông báo API Play Grouping cho người dùng PGS được xác định bằng Mã phiên hoạt động gọi lại được cung cấp trong yêu cầu. |
Phương thức |
list |
GET /games/v1/achievements
Liệt kê tất cả định nghĩa thành tích cho ứng dụng của bạn. |
Phương thức |
increment |
POST /games/v1/achievements/{achievementId}/increment
Tăng số bước của thành tích bằng mã nhận dạng đã cho cho người chơi hiện đã được xác thực. |
list |
GET /games/v1/players/{playerId}/achievements
Liệt kê tiến trình của tất cả thành tích trong ứng dụng của bạn cho người chơi hiện được xác thực. |
reveal |
POST /games/v1/achievements/{achievementId}/reveal
Đặt trạng thái của thành tích có mã nhận dạng đã cho thành REVEALED đối với người chơi hiện đã được xác thực. |
setStepsAtLeast |
POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Đặt các bước để người chơi hiện đã được xác thực để mở khóa một thành tích. |
unlock |
POST /games/v1/achievements/{achievementId}/unlock
Mở khóa thành tích này cho người chơi hiện đã được xác thực. |
updateMultiple |
POST /games/v1/achievements/updateMultiple
Cập nhật nhiều thành tích cho người chơi hiện đã được xác thực. |
Phương thức |
get |
GET /games/v1/applications/{applicationId}
Truy xuất siêu dữ liệu của ứng dụng bằng mã nhận dạng đã cho. |
getEndPoint |
POST /games/v1/applications/getEndPoint
Trả về URL cho loại điểm cuối được yêu cầu. |
played |
POST /games/v1/applications/played
Cho biết rằng người dùng hiện đã xác thực đang phát ứng dụng của bạn. |
verify |
GET /games/v1/applications/{applicationId}/verify
Xác minh mã thông báo xác thực được cung cấp kèm theo yêu cầu này là dành cho ứng dụng có mã nhận dạng được chỉ định và trả về mã nhận dạng của người chơi được cấp mã nhận dạng đó. |
Tài nguyên REST: events
Phương thức |
listByPlayer |
GET /games/v1/events
Trả về danh sách hiển thị tiến trình hiện tại của các sự kiện trong ứng dụng này đối với người dùng đang được xác thực. |
listDefinitions |
GET /games/v1/eventDefinitions
Trả về danh sách các định nghĩa sự kiện trong ứng dụng này. |
record |
POST /games/v1/events
Ghi lại một loạt các thay đổi về số lần sự kiện đã xảy ra đối với người dùng hiện đã được xác thực của ứng dụng này. |
Phương thức |
get |
GET /games/v1/leaderboards/{leaderboardId}
Truy xuất siêu dữ liệu của bảng xếp hạng bằng mã nhận dạng đã cho. |
list |
GET /games/v1/leaderboards
Liệt kê tất cả siêu dữ liệu bảng xếp hạng cho ứng dụng của bạn. |
Phương thức |
get |
GET /games/v1/players/{playerId}
Truy xuất tài nguyên Trình phát bằng mã nhận dạng đã cho. |
getMultipleApplicationPlayerIds |
GET /games/v1/players/me/multipleApplicationPlayerIds
Lấy mã trình phát ứng dụng của người chơi hiện được xác thực trên tất cả các trò chơi được yêu cầu bởi cùng một nhà phát triển dưới dạng ứng dụng gọi. |
getScopedPlayerIds |
GET /games/v1/players/me/scopedIds
Truy xuất giá trị nhận dạng người chơi trong phạm vi của người dùng hiện đã được xác thực. |
list |
GET /games/v1/players/me/players/{collection}
Lấy tập hợp người chơi cho người dùng hiện đã được xác thực. |
Tài nguyên REST: recall
Phương thức |
gamesPlayerTokens |
GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Truy xuất mã gọi lại từ tất cả trò chơi được yêu cầu có liên kết với Trình chơi PGS được mã hoá theo mã phiên hoạt động gọi lại được cung cấp. |
lastTokenFromAllDeveloperGames |
GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Truy xuất mã gọi lại gần đây nhất từ tất cả trò chơi của nhà phát triển liên kết với Trình chơi PGS được mã hoá theo mã phiên hoạt động gọi lại được cung cấp. |
linkPersona |
POST /games/v1/recall:linkPersona
Liên kết với một tài khoản trong trò chơi để liên kết với người chơi gốc PGS được mã hoá theo mã phiên hoạt động gọi lại được cung cấp |
resetPersona |
POST /games/v1/recall:resetPersona
Xoá tất cả mã gọi lại liên kết persona đó với bất kỳ người chơi nào (có hoặc không có hồ sơ). |
retrieveTokens |
GET /games/v1/recall/tokens/{sessionId}
Truy xuất tất cả mã gọi lại liên kết với Trình phát PGS được mã hoá theo mã phiên hoạt động gọi lại được cung cấp. |
unlinkPersona |
POST /games/v1/recall:unlinkPersona
Xoá Mã gọi lại để liên kết tài khoản chính của Người chơi PGS được xác định trong Phiên gọi lại với một tài khoản trong trò chơi được xác định theo "persona" hoặc theo giá trị mã thông báo. |
Phương thức |
check |
GET /games/v1/revisions/check
Kiểm tra xem ứng dụng trò chơi có lỗi thời hay không. |
Tài nguyên REST: scores
Phương thức |
get |
GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Đạt điểm cao và thứ hạng (không bắt buộc) trong bảng xếp hạng dành cho người chơi đang được xác thực. |
list |
GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Liệt kê điểm số trong một bảng xếp hạng, bắt đầu từ hàng đầu. |
listWindow |
GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Liệt kê điểm số trong một bảng xếp hạng xung quanh (và bao gồm cả) điểm của người chơi. |
submit |
POST /games/v1/leaderboards/{leaderboardId}/scores
Gửi điểm số tới bảng xếp hạng đã chỉ định. |
submitMultiple |
POST /games/v1/leaderboards/scores
Gửi nhiều điểm số lên bảng xếp hạng. |
Tài nguyên REST: snapshot (ảnh chụp nhanh)
Phương thức |
get |
GET /games/v1/snapshots/{snapshotId}
Truy xuất siêu dữ liệu cho một mã bản tổng quan nhanh nhất định. |
list |
GET /games/v1/players/{playerId}/snapshots
Truy xuất danh sách ảnh chụp nhanh do ứng dụng của bạn tạo cho trình phát tương ứng với mã nhận dạng người chơi. |
Tài nguyên REST: stats
Phương thức |
get |
GET /games/v1/stats
Trả về số liệu thống kê về mức độ tương tác và chi tiêu trong ứng dụng này cho người dùng hiện đã được xác thực. |