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.