Method: achievements.increment

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

درخواست HTTP

POST https://games.googleapis.com/games/v1/achievements/{achievementId}/increment

پارامترهای مسیر

پارامترها
achievementId

string

شناسه دستاورد مورد استفاده در این روش.

پارامترهای پرس و جو

پارامترها
requestId

string ( int64 format)

یک شناسه عددی به‌طور تصادفی برای هر درخواستی که توسط تماس‌گیرنده مشخص شده است. این شماره در سرور استفاده می شود تا اطمینان حاصل شود که درخواست در طول تلاش های مجدد به درستی انجام می شود.

stepsToIncrement

integer

مورد نیاز. تعداد مراحل افزایش.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

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

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

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

string

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

currentSteps

integer

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

newlyUnlocked

boolean

آیا مراحل فعلی دستاورد به تعداد مراحل لازم برای باز کردن قفل رسیده است یا خیر.

محدوده مجوز

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

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

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