يتطلّب تفويضًا
يمكنك إخفاء قائمة المشغّلات من التطبيق المحدّد. لا تتوفَّر هذه الطريقة إلا لحسابات المستخدمين في Play Console.
الطلب
طلب HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
المعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات المسار | ||
applicationId |
string |
رقم تعريف التطبيق الوارد في Google Play Console |
مَعلمات طلب البحث الاختيارية | ||
maxResults |
integer |
الحد الأقصى لعدد موارد اللاعب التي يمكن عرضها في الردّ، ويتم استخدامه لنقل البيانات بالنسبة إلى أي استجابة، قد يكون العدد الفعلي لموارد اللاعب التي تم عرضها أقل من maxResults المحدّدة.
تتراوح القيم المقبولة بين 1 و15 بشكل شامل.
|
pageToken |
string |
الرمز المميّز الذي تم عرضه من خلال الطلب السابق |
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي (مزيد من المعلومات عن المصادقة والترخيص).
النطاق |
---|
https://www.googleapis.com/auth/games |
نص الطلب
لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.
الرد
في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
اسم الموقع | القيمة | الوصف | ملاحظات |
---|---|---|---|
kind |
string |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة gamesManagement#hiddenPlayerList . |
|
nextPageToken |
string |
هو الرمز المميّز للتقسيم على صفحات للصفحة التالية من النتائج. | |
items[] |
list |
اللاعبون. | |
items[].kind |
string |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة gamesManagement#hiddenPlayer . |
|
items[].player |
nested object |
معلومات عن المشغّل | |
items[].player.kind |
string |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة gamesManagement#player . |
|
items[].player.playerId |
string |
رقم تعريف المشغّل. | |
items[].player.displayName |
string |
الاسم الذي سيتم عرضه للمشغّل | |
items[].player.avatarImageUrl |
string |
تمثّل هذه السمة عنوان URL الأساسي للصورة التي تمثّل المشغّل. | |
items[].player.lastPlayedWith |
nested object |
تفاصيل حول آخر مرة لعب فيها هذا اللاعب لعبة متعدّدة اللاعبين مع لاعب تمت مصادقته حاليًا تتم التعبئة لأعضاء مجموعة اللاعبين PLAYED_WITH. | |
items[].player.lastPlayedWith.timeMillis |
long |
آخر مرة شغّل فيها اللاعب اللعبة بالمللي ثانية منذ حقبة التوقيت العالمي المنسَّق (UTC). | |
items[].player.lastPlayedWith.autoMatched |
boolean |
صحيح إذا تم إجراء مطابقة تلقائية للمشغّل مع المستخدم الذي تمت مصادقته حاليًا. | |
items[].player.name |
object |
تمثيل كائن للمكوّنات الفردية لاسم اللاعب. قد لا تتوفّر هذه الحقول لدى بعض اللاعبين. | |
items[].player.name.familyName |
string |
اسم عائلة هذا اللاعب وفي بعض الأماكن، يُعرف هذا الاسم باسم العائلة. | |
items[].player.name.givenName |
string |
الاسم المحدّد لهذا اللاعب يُعرف هذا الاسم في بعض الأماكن باسم الاسم الأول. | |
items[].player.experienceInfo |
nested object |
تمثّل هذه السمة كائنًا لتمثيل معلومات تجربة "لعبة Play" للّاعب. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
العدد الحالي لنقاط الخبرة للّاعب | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
الطابع الزمني لوقت الارتقاء بمستوى المشغّل، بالمللي ثانية منذ تاريخ Unix للّعبة بالتوقيت العالمي المنسّق | |
items[].player.experienceInfo.currentLevel |
nested object |
المستوى الحالي للّاعب. | |
items[].player.experienceInfo.currentLevel.level |
integer |
مستوى المستخدم. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
تمثّل هذه السمة الحدّ الأدنى لنقاط الخبرة لهذا المستوى. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
تمثّل هذه السمة الحد الأقصى لنقاط الخبرة لهذا المستوى. | |
items[].player.experienceInfo.nextLevel |
nested object |
المستوى التالي من اللاعب. إذا كان المستوى الحالي هو الحد الأقصى، يجب أن يكون هذا المستوى مماثلاً للمستوى الحالي. | |
items[].player.experienceInfo.nextLevel.level |
integer |
مستوى المستخدم. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
تمثّل هذه السمة الحدّ الأدنى لنقاط الخبرة لهذا المستوى. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
تمثّل هذه السمة الحد الأقصى لنقاط الخبرة لهذا المستوى. | |
items[].player.title |
string |
هو لقب اللاعب كمكافأة مقابل أنشطته في اللعبة. |