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 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 (UpdatedAchievement)
    }
  ]
}
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 games#achievementUpdateMultipleResponse cố định.
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 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 (UpdateAchievement)
    }
  ]
}
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 games#achievementUpdateMultipleRequest cố định.
updates[]

object (UpdateAchievement)

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 (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
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 games#achievementUpdateRequest cố định.
achievementId

string

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

enum (AchievementUpdateType)

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

object (AchievementIncrement)

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

object (SetAchievementSteps)

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

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

string

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

integer

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

string (int64 format)

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

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi games#GamesAchievementSetStepsAtLeast cố định.
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
}
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 games#achievementUpdateResponse cố định.
achievementId

string

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

boolean

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

enum (UpdatedAchievementState)

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

integer

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

boolean

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