- HTTP 请求
- 请求正文
- 响应正文
- 授权范围
- UpdateMultipleAchievements
- UpdateAchievement
- AchievementUpdateType
- AchievementIncrement
- SetAchievementSteps
- UpdatedAchievement
- UpdatedAchievementState
- 试试看!
更新当前已认证玩家的多个成就。
HTTP 请求
POST https://games.googleapis.com/games/v1/achievements/updateMultiple
请求正文
请求正文包含一个 UpdateMultipleAchievements
实例。
响应正文
achievements.updateMultiple RPC 的响应消息。
如果成功,响应正文包含具有以下结构的数据
JSON 表示 |
---|
{
"kind": string,
"updatedAchievements": [
{
object ( |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
updatedAchievements[] |
成就的更新状态。 |
授权范围
需要以下 OAuth 范围之一
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
如需了解更多信息,请参阅 OAuth 2.0 概览。
UpdateMultipleAchievements
成就更新请求列表。
JSON 表示 |
---|
{
"kind": string,
"updates": [
{
object ( |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
updates[] |
单个成就更新请求。 |
UpdateAchievement
更新成就的请求。
JSON 表示 |
---|
{ "kind": string, "achievementId": string, "updateType": enum ( |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
achievementId |
此更新所应用于的成就。 |
updateType |
应用的更新类型。 |
incrementPayload |
如果对成就请求了 |
setStepsAtLeastPayload |
如果对成就请求了 |
AchievementUpdateType
可能的成就更新类型。
枚举 | |
---|---|
REVEAL |
成就已揭示。 |
UNLOCK |
成就已解锁。 |
INCREMENT |
成就已递增。 |
SET_STEPS_AT_LEAST |
成就进度设置为至少传递的值。 |
AchievementIncrement
请求递增成就的载荷。
JSON 表示 |
---|
{ "kind": string, "steps": integer, "requestId": string } |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
steps |
要递增的步数。 |
requestId |
与成就递增相关的 requestId。 |
SetAchievementSteps
请求递增成就的载荷。
JSON 表示 |
---|
{ "kind": string, "steps": integer } |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
steps |
要为成就设置的最小步数。 |
UpdatedAchievement
一个更新后的成就。
JSON 表示 |
---|
{
"kind": string,
"achievementId": string,
"updateOccurred": boolean,
"currentState": enum ( |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
achievementId |
此更新所应用的成就。 |
updateOccurred |
请求的更新是否确实影响了成就。 |
currentState |
成就的当前状态。 |
currentSteps |
如果此成就是递增的,则为记录的当前步数。 |
newlyUnlocked |
此成就是否刚刚解锁(即对成就的解锁请求是否是玩家的第一次请求)。 |
UpdatedAchievementState
可能的更新成就状态。
枚举 | |
---|---|
HIDDEN |
成就已隐藏。 |
REVEALED |
成就已揭示。 |
UNLOCKED |
成就已解锁。 |