Google Play Game Services

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.

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.