Method: achievements.updateMultiple

لتحديث الإنجازات المتعددة للمشغل الذي تمت مصادقته حاليًا.

طلب HTTP

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

نص الطلب

يحتوي نص الطلب على مثال UpdateMultipleAchievements.

نص الاستجابة

رسالة الرد لـ developers.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

أنواع تحديثات الإنجازات المحتمَلة

عمليات التعداد
REVEAL يتم الكشف عن الإنجاز.
UNLOCK فتح إنجاز
INCREMENT الإنجاز يزداد.
SET_STEPS_AT_LEAST يتم ضبط تقدم الإنجاز على القيمة التي تم تمريرها على الأقل.

AchievementIncrement

الحمولة المطلوب طلب زيادة أحد الإنجازات.

تمثيل JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
الحقول
kind

string

يحدِّد نوع هذا المورد بشكلٍ فريد. القيمة هي دائمًا السلسلة الثابتة games#GamesAchievementIncrement.
steps

integer

عدد الخطوات المطلوب زيادتها.
requestId

string (int64 format)

رقم تعريف الطلب المرتبط بزيادة في إنجاز.

SetAchievementSteps

الحمولة المطلوب طلب زيادة أحد الإنجازات.

تمثيل JSON 
{
  "kind": string,
  "steps": integer
}
الحقول
kind

string

يحدِّد نوع هذا المورد بشكلٍ فريد. القيمة هي دائمًا السلسلة الثابتة games#GamesAchievementSetStepsAtLeast.
steps

integer

الحد الأدنى لعدد الخطوات المطلوب تعيين الإنجاز إليها.

UpdatedAchievement

إنجاز تم تعديله.

تمثيل 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

حالات الإنجازات المعدَّلة المحتملة

عمليات التعداد
HIDDEN الإنجاز مخفي.
REVEALED يتم الكشف عن الإنجاز.
UNLOCKED فتح إنجاز