- طلب HTTP
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- UpdateMultipleAchievements
- UpdateAchievement
- AchievementUpdateType
- AchievementIncrement
- SetAchievementSteps
- UpdatedAchievement
- UpdatedAchievementState
- جرِّبه الآن
لتعديل إنجازات متعددة للمشغّل الذي تمت مصادقته حاليًا.
طلب HTTP
POST https://games.googleapis.com/games/v1/achievements/updateMultiple
نص الطلب
يحتوي نص الطلب على مثال UpdateMultipleAchievements
.
نص الاستجابة
رسالة الاستجابة للمُعامِلات arrange.updateMultiple rpc.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"updatedAchievements": [
{
object ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
updatedAchievements[] |
تمثّل هذه السمة الحالة المعدّلة للإنجازات. |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
UpdateMultipleAchievements
قائمة بطلبات تعديل الإنجازات
تمثيل JSON |
---|
{
"kind": string,
"updates": [
{
object ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
updates[] |
طلبات تعديل الإنجاز الفردي. |
UpdateAchievement
طلب لتعديل إنجاز
تمثيل JSON |
---|
{ "kind": string, "achievementId": string, "updateType": enum ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
achievementId |
الإنجاز الذي يتم تطبيق هذا التعديل عليه. |
updateType |
نوع التحديث الذي يتم تطبيقه. |
incrementPayload |
الحمولة في حال طلب تحديث من النوع |
setStepsAtLeastPayload |
الحمولة في حال طلب تحديث من النوع |
AchievementUpdateType
أنواع تعديلات الإنجازات المحتملة.
عمليات التعداد | |
---|---|
REVEAL |
يتم كشف الإنجاز. |
UNLOCK |
إنجاز مفتوح. |
INCREMENT |
تزداد الإنجاز. |
SET_STEPS_AT_LEAST |
تم ضبط تقدم الإنجازات على القيمة التي تم تمريرها على الأقل. |
AchievementIncrement
الحمولة المطلوبة لزيادة إنجاز معيّن.
تمثيل JSON |
---|
{ "kind": string, "steps": integer, "requestId": string } |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
steps |
عدد الخطوات المطلوب زيادتها. |
requestId |
رقم تعريف الطلب المرتبط بزيادة في إنجاز معيّن |
SetAchievementSteps
الحمولة المطلوبة لزيادة إنجاز معيّن.
تمثيل JSON |
---|
{ "kind": string, "steps": integer } |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
steps |
الحد الأدنى لعدد الخطوات المطلوب ضبط الإنجاز عليها. |
UpdatedAchievement
إنجاز تم تعديله.
تمثيل JSON |
---|
{
"kind": string,
"achievementId": string,
"updateOccurred": boolean,
"currentState": enum ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
achievementId |
الإنجاز الذي تم تطبيق هذا التعديل عليه |
updateOccurred |
ما إذا كانت التحديثات المطلوبة قد أثّرت في الإنجاز أم لا |
currentState |
الحالة الحالية للإنجاز. |
currentSteps |
الخطوات الحالية المسجَّلة لهذا الإنجاز إذا كان تدريجيًّا. |
newlyUnlocked |
تشير هذه السمة إلى ما إذا كان قد تم فتح قفل هذا الإنجاز حديثًا (أي ما إذا كان طلب فتح الإنجاز هو الأول للّاعب). |
UpdatedAchievementState
حالات الإنجاز المحتمَلة المعدَّلة
عمليات التعداد | |
---|---|
HIDDEN |
الإنجاز مخفي. |
REVEALED |
يتم كشف الإنجاز. |
UNLOCKED |
إنجاز مفتوح. |