- طلب HTTP
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- UpdateMultipleAchievements
- UpdateAchievement
- AchievementUpdateType
- AchievementIncrement
- SetAchievementSteps
- UpdatedAchievement
- UpdatedAchievementState
- جرِّبه الآن
لتحديث الإنجازات المتعددة للمشغل الذي تمت مصادقته حاليًا.
طلب HTTP
POST https://games.googleapis.com/games/v1/achievements/updateMultiple
نص الطلب
يحتوي نص الطلب على مثال UpdateMultipleAchievements
.
نص الاستجابة
رسالة الرد لـ developers.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 |
فتح إنجاز |