Google Play Games Services API

Dịch vụ Google Play Games 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à nhiều tính năng khác.

Dịch vụ: games.googleapis.com

Để gọi dịch vụ này, bạn nên dùng thư viện ứng dụng do Google cung cấp. Nếu ứng dụng của bạn cần dùng các thư viện riêng để gọi dịch vụ này, hãy sử dụng thông tin sau khi bạn thực hiện các yêu cầu API.

Tài liệu khám phá

Tài liệu khám phá là một quy cách có thể đọc được bằng máy để mô tả và sử dụng API REST. Quy cách này được dùng để tạo các thư viện ứng dụng, trình bổ trợ IDE và các công cụ khác 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 dịch vụ là một URL cơ sở chỉ định địa chỉ mạng của một 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 và tất 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 Play Grouping API 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 Play Grouping API cho người dùng PGS được xác định bằng mã phiên hoạt động Gọi lại có 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ả các định nghĩa về thành tích cho ứng dụng của bạn.

Tài nguyên REST: achievements

Phương thức
increment POST /games/v1/achievements/{achievementId}/increment
Tăng số bước của thành tích có mã nhận dạng đã cho cho người chơi hiện đang đượ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 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 cho 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 đạt được 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 đượ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 có 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 tại đã 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 uỷ quyền được cung cấp cùng với yêu cầu này là dành cho ứng dụng có mã nhận dạng đã chỉ định và trả về mã nhận dạng của người chơi được cấp mã thông báo đó.

Tài nguyên REST: events

Phương thức
listByPlayer GET /games/v1/events
Trả về một danh sách cho biết 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 hiện tại đã 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 thay đổi về số lần xảy ra sự kiện cho người dùng hiện tại đã được xác thực của ứng dụng này.

Tài nguyên REST: leaderboards

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 có 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 chơi được tổng hợp theo danh mục cho người chơi tương ứng với playerId.

Tài nguyên REST: playerGameEvents

Phương thức
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Ghi lại một loạt sự kiện trò chơi của người chơi cho một người chơi cụ thể.

Tài nguyên REST: players

Phương thức
get GET /games/v1/players/{playerId}
Truy xuất tài nguyên Người chơi có mã nhận dạng đã cho.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Lấy mã nhận dạng người chơi của ứng dụng cho 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 của 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 có phạm vi cho người dùng hiện đã được xác thực.
list GET /games/v1/players/me/players/{collection}
Lấy bộ sưu tập người chơi cho người dùng hiện tại đã 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ả các trò chơi được yêu cầu có liên kết với Người chơi PGS được mã hoá trong mã nhận dạng phiên gọi lại đã 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ả các trò chơi của nhà phát triển được liên kết với Người chơi PGS được mã hoá trong mã nhận dạng phiên gọi lại đã cung cấp.
linkPersona POST /games/v1/recall:linkPersona
Liên kết đối tượng Người chơi PGS được mã hoá trong mã nhận dạng phiên gọi lại đã 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ã thông báo Recall liên kết nhân vật đã cho 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 được liên kết với Người chơi PGS được mã hoá trong mã nhận dạng phiên gọi lại đã cung cấp.
unlinkPersona POST /games/v1/recall:unlinkPersona
Xoá mã gọi lại liên kết với đối tượng chính là Người chơi PGS do phiên Gọi lại xác định 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: revisions

Phương thức
check GET /games/v1/revisions/check
Kiểm tra xem ứng dụng trò chơi đã lỗi thời hay chưa.

Tài nguyên REST: scores

Phương thức
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Nhận điểm số cao và thứ hạng (không bắt buộc) trong bảng xếp hạng 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 bảng xếp hạng, bắt đầu từ điểm số cao nhất.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Liệt kê điểm số trong bảng xếp hạng xung quanh (và bao gồm) điểm số 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 REST: snapshots

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 ảnh chụp 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 người chơi 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 độ gắn bó và mức chi tiêu trong ứng dụng này cho người dùng hiện đã xác thực.