Method: achievements.updateMultiple

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

طلب HTTP

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

نص الطلب

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

نص الاستجابة

رسالة الاستجابة للمُعامِلات arrange.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 إنجاز مفتوح.