- HTTP 请求
- 请求正文
- 响应正文
- 授权范围
- UpdateMultipleAchievements
- UpdateAchievement
- AchievementUpdateType
- AchievementIncrement
- SetAchievementSteps
- UpdatedAchievement
- UpdatedAchievementState
- 试试看!
为当前已通过身份验证的玩家更新多项成就。
HTTP 请求
POST https://games.googleapis.com/games/v1/achievements/updateMultiple
请求正文
请求正文包含一个 UpdateMultipleAchievements
实例。
响应正文
成就.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 |
已解锁成就。 |