- طلب HTTP
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- AchievementDefinition
- AchievementType
- InitialAchievementState
- جرِّبه الآن
يسرد جميع تعريفات الإنجازات لتطبيقك.
طلب HTTP
GET https://games.googleapis.com/games/v1/achievements
معامِلات طلب البحث
المعلمات | |
---|---|
language |
اللغة المفضلة المراد استخدامها للسلاسل التي يتم عرضها بهذه الطريقة. |
maxResults |
الحد الأقصى لعدد موارد الإنجاز التي سيتم عرضها في الرد، ويتم استخدامه للترقيم. بالنسبة إلى أي استجابة، قد يكون العدد الفعلي لموارد الإنجاز التي يتم عرضها أقل من قيمة |
pageToken |
الرمز المميّز الذي تم عرضه من خلال الطلب السابق |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بكائنات تعريف الإنجازات
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
nextPageToken |
الرمز المميّز المقابل لصفحة النتائج التالية. |
items[] |
تعريفات الإنجاز. |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
AchievementDefinition
كائن تعريف الإنجاز
تمثيل JSON |
---|
{ "kind": string, "id": string, "name": string, "description": string, "achievementType": enum ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
id |
رقم تعريف الإنجاز. |
name |
اسم الإنجاز. |
description |
وصف الإنجاز. |
achievementType |
نوع الإنجاز. |
totalSteps |
يشير ذلك المصطلح إلى إجمالي الخطوات المرتبطة بإنجاز تدريجي. |
formattedTotalSteps |
إجمالي الخطوات لإنجاز متزايد كسلسلة. |
revealedIconUrl |
عنوان URL للصورة لرمز الإنجاز الذي تم عرضه. |
isRevealedIconUrlDefault |
يشير هذا الرمز إلى ما إذا كانت صورة الرمز التي يتم عرضها هي صورة تلقائية أو مقدَّمة من اللعبة. |
unlockedIconUrl |
عنوان URL للصورة لرمز الإنجاز الذي تم فتح قفله. |
isUnlockedIconUrlDefault |
يشير هذا الرمز إلى ما إذا كانت صورة رمز فتح القفل التي يتم عرضها هي صورة تلقائية أو مقدَّمة من لعبة. |
initialState |
الحالة الأولية للإنجاز. |
experiencePoints |
مكافآت الخبرة التي سيتم الحصول عليها عند فتح هذا الإنجاز |
AchievementType
أنواع الإنجازات المحتملة.
عمليات التعداد | |
---|---|
STANDARD |
الإنجاز إمّا مقفل أو مفتوح. |
INCREMENTAL |
الإنجاز تدريجي. |
InitialAchievementState
الحالات الأولية المحتملة لإنجاز ما.
عمليات التعداد | |
---|---|
HIDDEN |
الإنجاز مخفي. |
REVEALED |
يتم كشف الإنجاز. |
UNLOCKED |
إنجاز مفتوح. |