Method: achievements.updateMultiple

چندین دستاورد را برای پخش کننده تأیید شده فعلی به روز می کند.

درخواست HTTP

POST https://games.googleapis.com/games/v1/achievements/updateMultiple

درخواست بدن

بدنه درخواست شامل یک نمونه از UpdateMultipleAchievements است.

بدن پاسخگو

پیام پاسخ برای achievements.updateMultiple rpc.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#achievementUpdateMultipleResponse .

updatedAchievements[]

object ( UpdatedAchievement )

وضعیت به روز دستاوردها.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

UpdateMultipleAchievements

فهرستی از درخواست‌های به‌روزرسانی دستاورد.

نمایندگی JSON 
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#achievementUpdateMultipleRequest .

updates[]

object ( UpdateAchievement )

درخواست‌های به‌روزرسانی دستاوردهای فردی.

UpdateAchievement

درخواستی برای به روز رسانی یک دستاورد.

نمایندگی JSON 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#achievementUpdateRequest .

achievementId

string

دستاوردی که این به‌روزرسانی برای آن اعمال می‌شود.

updateType

enum ( AchievementUpdateType )

نوع به روز رسانی در حال اعمال

incrementPayload

object ( AchievementIncrement )

اگر یک به‌روزرسانی از نوع INCREMENT برای دستاورد درخواست شده باشد، محموله است.

setStepsAtLeastPayload

object ( SetAchievementSteps )

اگر یک به‌روزرسانی از نوع SET_STEPS_AT_LEAST برای دستاورد درخواست شده باشد، محموله است.

AchievementUpdateType

انواع به روز رسانی دستاوردهای احتمالی

Enums
REVEAL دستاورد آشکار می شود.
UNLOCK قفل دستاورد باز شده است.
INCREMENT دستاورد افزایش یافته است.
SET_STEPS_AT_LEAST پیشرفت دستاورد حداقل روی مقدار تصویب شده تنظیم می شود.

افزایش دستاورد

محموله مورد درخواست برای افزایش یک دستاورد.

نمایندگی JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#GamesAchievementIncrement .

steps

integer

تعداد مراحلی که باید افزایش یابد.

requestId

string ( int64 format)

RequestId مربوط به افزایش یک دستاورد است.

SetAchievementSteps

محموله مورد درخواست برای افزایش یک دستاورد.

نمایندگی JSON 
{
  "kind": string,
  "steps": integer
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#GamesAchievementSetStepsAtLeast .

steps

integer

حداقل تعداد مراحلی که برای دستاورد باید تنظیم شود.

به روز رسانی دستاورد

یک دستاورد به روز شده

نمایندگی JSON 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#achievementUpdateResponse .

achievementId

string

دستاوردی که این به‌روزرسانی برای آن اعمال شد.

updateOccurred

boolean

اینکه آیا به‌روزرسانی‌های درخواستی واقعاً بر دستاورد تأثیر گذاشته است یا خیر.

currentState

enum ( UpdatedAchievementState )

وضعیت فعلی دستاورد.

currentSteps

integer

مراحل فعلی ثبت شده برای این دستاورد اگر افزایشی باشد.

newlyUnlocked

boolean

اینکه آیا این اچیومنت به تازگی آنلاک شده است یا نه (یعنی آیا درخواست باز کردن قفل برای اچیومنت اولین مورد برای بازیکن بوده است).

UpdatedAchievementState

وضعیت های دستاورد به روز شده احتمالی.

Enums
HIDDEN دستاورد پنهان است.
REVEALED دستاورد آشکار می شود.
UNLOCKED قفل دستاورد باز شده است.