- Yêu cầu HTTP
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- UpdateMultipleAchievements
- UpdateAchievement
- AchievementUpdateType
- AchievementIncrement
- SetAchievementSteps
- UpdatedAchievement
- UpdatedAchievementState
- Hãy làm thử!
Cập nhật nhiều thành tích cho người chơi hiện đã được xác thực.
Yêu cầu HTTP
POST https://games.googleapis.com/games/v1/achievements/updateMultiple
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của UpdateMultipleAchievements
.
Nội dung phản hồi
Thông báo phản hồi cho assets.updateMultiple rpc.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"kind": string,
"updatedAchievements": [
{
object ( |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
updatedAchievements[] |
Trạng thái cập nhật của thành tích. |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
UpdateMultipleAchievements
Danh sách các yêu cầu cập nhật thành tích.
Biểu diễn dưới dạng JSON |
---|
{
"kind": string,
"updates": [
{
object ( |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
updates[] |
Các yêu cầu cập nhật thành tích của từng người. |
UpdateAchievement
Yêu cầu cập nhật thành tích.
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "achievementId": string, "updateType": enum ( |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
achievementId |
Thành tích mà bản cập nhật này đang áp dụng. |
updateType |
Loại nội dung cập nhật đang được áp dụng. |
incrementPayload |
Tải trọng nếu đã yêu cầu cập nhật loại |
setStepsAtLeastPayload |
Tải trọng nếu đã yêu cầu cập nhật loại |
AchievementUpdateType
Các loại thông tin cập nhật thành tích có thể có.
Enum | |
---|---|
REVEAL |
Thành tích đã được tiết lộ. |
UNLOCK |
Thành tích đã được mở khoá. |
INCREMENT |
Thành tích được tăng lên. |
SET_STEPS_AT_LEAST |
Tiến trình của thành tích sẽ được đặt ở mức tối thiểu là giá trị đã vượt qua. |
AchievementIncrement
Tải trọng để yêu cầu tăng một thành tích.
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "steps": integer, "requestId": string } |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
steps |
Số bước sẽ được tăng lên. |
requestId |
requestId được liên kết với mức tăng cho một thành tích. |
SetAchievementSteps
Tải trọng để yêu cầu tăng một thành tích.
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "steps": integer } |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
steps |
Số bước tối thiểu để đặt thành tích. |
UpdatedAchievement
Một thành tích đã cập nhật.
Biểu diễn dưới dạng JSON |
---|
{
"kind": string,
"achievementId": string,
"updateOccurred": boolean,
"currentState": enum ( |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
achievementId |
Thành tích đã áp dụng bản cập nhật này. |
updateOccurred |
Liệu các bản cập nhật được yêu cầu có thực sự ảnh hưởng đến thành tích đạt được hay không. |
currentState |
Trạng thái hiện tại của thành tích. |
currentSteps |
Các bước hiện tại được ghi lại cho thành tích này (nếu có tăng dần). |
newlyUnlocked |
Liệu thành tích này có phải là thành tích mới được mở khóa hay không (nghĩa là yêu cầu mở khóa cho thành tích này có phải là yêu cầu đầu tiên của người chơi hay không). |
UpdatedAchievementState
Các trạng thái có thể được cập nhật của thành tích.
Enum | |
---|---|
HIDDEN |
Thành tích bị ẩn. |
REVEALED |
Thành tích đã được tiết lộ. |
UNLOCKED |
Thành tích đã được mở khoá. |