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 bằng 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.v.
- Tài nguyên Kiến trúc chuyển trạng thái đại diện (REST): định nghĩa thành tích
- Tài nguyên REST: thành tích
- Tài nguyên REST: ứng dụng
- Tài nguyên REST: sự kiện
- Tài nguyên REST: bảng xếp hạng
- Tài nguyên REST: metagame
- Tài nguyên REST: người chơi
- Tài nguyên REST: Recall
- Tài nguyên REST: bản sửa đổi
- Tài nguyên REST: điểm số
- Tài nguyên REST: ảnh chụp nhanh
- Tài nguyên REST: số liệu thống kê
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ủa bạn 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 đây khi đưa ra yêu cầu API.
Tài liệu khám phá
Tài liệu khám phá là một thông số kỹ thuật mà máy đọc được để mô tả và sử dụng các API REST. API này được dùng để xây dựng 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 các 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 đây:
Điểm cuối dịch vụ
Điểm cuối 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 của 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 của dịch vụ này:
https://games.googleapis.com
Tài nguyên REST: achievementDefinitions
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. |
Tài nguyên REST: thành tích
Phương thức | |
---|---|
increment |
POST /games/v1/achievements/{achievementId}/increment Tăng các bước của thành tích với 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ả các thành tích của ứng dụng của bạn đối với 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 cho người chơi hiện đã xác thực. |
setStepsAtLeast |
POST /games/v1/achievements/{achievementId}/setStepsAtLeast Thiết lập các bước để người chơi hiện đã được xác thực mở khoá thành tích. |
unlock |
POST /games/v1/achievements/{achievementId}/unlock Mở khoá thành tích này cho người chơi hiện đã 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 đã xác thực. |
Tài nguyên REST: applications
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 người dùng hiện đã được 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 đã chỉ định, đồng thời trả về mã của trình phát được cấp. |
Tài nguyên REST: events
Phương thức | |
---|---|
listByPlayer |
GET /games/v1/events Trả về danh sách cho thấy tiến trình hiện tại của các sự kiện trong ứng dụng này cho người dùng hiện đã đượ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. |
Tài nguyên REST: bảng xếp hạng
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 của bảng xếp hạng cho ứng dụng của bạn. |
Tài nguyên REST: metagame
Phương thức | |
---|---|
getMetagameConfig |
GET /games/v1/metagameConfig Trả về dữ liệu cấu hình metagame cho ứng dụng gọi. |
listCategoriesByPlayer |
GET /games/v1/players/{playerId}/categories/{collection} Liệt kê dữ liệu lượt phát được tổng hợp theo từng danh mục cho người chơi tương ứng với playerId . |
Tài nguyên REST: người chơi
Phương thức | |
---|---|
get |
GET /games/v1/players/{playerId} Truy xuất tài nguyên Trình phát có mã nhận dạng cho trước. |
getMultipleApplicationPlayerIds |
GET /games/v1/players/me/multipleApplicationPlayerIds Lấy mã nhận dạng người chơi trong ứng dụng của người chơi hiện đã xác thực trong tất cả các trò chơi mà cùng một nhà phát triển yêu cầu như ứ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 cho người dùng hiện đã xác thực. |
list |
GET /games/v1/players/me/players/{collection} Nhận tập hợp người chơi của người dùng hiện đã được xác thực. |
Tài nguyên REST: recall
Phương thức | |
---|---|
linkPersona |
POST /games/v1/recall:linkPersona Liên kết tên chính của Người chơi PGS được mã hoá trong mã phiên hoạt động gọi lại được cung cấp với một tài khoản trong trò chơi |
resetPersona |
POST /games/v1/recall:resetPersona Xoá tất cả Mã gọi lại liên kết persona cụ thể với người chơi bất kỳ (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 tên chính của Người chơi PGS được mã hoá bằng mã phiên thu hồi được cung cấp. |
unlinkPersona |
POST /games/v1/recall:unlinkPersona Xoá một mã gọi lại liên kết với người chơi chính của người chơi PGS được xác định trong phiên Recall và một tài khoản trong trò chơi được xác định bằng "persona" hoặc bằng giá trị mã thông báo. |
Tài nguyên REST: bản sửa đổi
Phương thức | |
---|---|
check |
GET /games/v1/revisions/check Kiểm tra xem ứng dụng trò chơi đã lỗi thời chưa. |
Tài nguyên REST: điểm
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 hiện đã đượ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ừ trên cùng. |
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) điểm của người chơi. |
submit |
POST /games/v1/leaderboards/{leaderboardId}/scores Gửi điểm số đến 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 Kiến trúc chuyển trạng thái đại diện (REST): ả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ã nhận dạng tổng quan nhanh nhất định. |
list |
GET /games/v1/players/{playerId}/snapshots Truy xuất danh sách các ả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: số liệu thống kê
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à mức chi tiêu trong ứng dụng này cho người dùng hiện đã được xác thực. |