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 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.

• Tài nguyên REST: accesstoken
• Tài nguyên REST: achievementĐịnh nghĩa
• 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: gọi lại
• 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: 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ầ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:

• https://games.googleapis.com/$discovery/rest?version=v1

Đ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

Tài nguyên REST: accesstokens

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.

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: achievement

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.

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 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.

Tài nguyên REST: hình chữ nhật dài

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.

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 chơi được tổng hợp theo mỗi 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 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.

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 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.