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.