Method: achievements.updateMultiple

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 thành tích.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 (UpdatedAchievement)
    }
  ]
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

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 Tổng quan về OAuth 2.0.

UpdateMultipleAchievements

Danh sách 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 (UpdateAchievement)
    }
  ]
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#achievementUpdateMultipleRequest.
updates[]

object (UpdateAchievement)

Yêu cầu cập nhật thành tích cá nhân.

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 (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#achievementUpdateRequest.
achievementId

string

Thành tích đang được áp dụng bản cập nhật này.
updateType

enum (AchievementUpdateType)

Loại cập nhật đang được áp dụng.
incrementPayload

object (AchievementIncrement)

Tải trọng này nếu có yêu cầu cập nhật loại INCREMENT cho thành tích.
setStepsAtLeastPayload

object (SetAchievementSteps)

Tải trọng này nếu có yêu cầu cập nhật loại SET_STEPS_AT_LEAST cho thành tích.

AchievementUpdateType

Các loại 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ở khóa.
INCREMENT Thành tích ngày càng tăng.
SET_STEPS_AT_LEAST Tiến trình thành tích được đặt thành ít nhất bằng giá trị đã vượt qua.

AchievementIncrement

Tải trọng để yêu cầu tăng thành tích.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#GamesAchievementIncrement.
steps

integer

Số bước sẽ được tăng lên.
requestId

string (int64 format)

Mã yêu cầu liên kết với một mức tăng của một thành tích.

SetAchievementSteps

Tải trọng để yêu cầu tăng thành tích.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "steps": integer
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#GamesAchievementSetStepsAtLeast.
steps

integer

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 (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#achievementUpdateResponse.
achievementId

string

Thành tích được áp dụng bản cập nhật này.
updateOccurred

boolean

Liệu nội dung cập nhật được yêu cầu có thực sự ảnh hưởng đến thành tích hay không.
currentState

enum (UpdatedAchievementState)

Trạng thái hiện tại của thành tích.
currentSteps

integer

Số bước hiện tại được ghi lại cho thành tích này nếu đó là số bước tăng dần.
newlyUnlocked

boolean

Liệu thành tích này có mới được mở khoá hay không (nghĩa là yêu cầu mở khoá thành tích có phải là lần đầu tiên người chơi yêu cầu mở khoá thành tích hay không).

UpdatedAchievementState

Các trạng thái thành tích đã cập nhật (nếu có).

Enum
HIDDEN Thành tích bị ẩn.
REVEALED Thành tích đã được tiết lộ.
UNLOCKED Thành tích đã được mở khóa.