يجب تقديم تفويض
يمكنك الحصول على قائمة باللاعبين المخفيين من التطبيق المعني. لا تتوفّر هذه الطريقة إلا لحسابات المستخدمين في وحدة تحكُّم المطوِّر.
الطلب
طلب 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 } ] }
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
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 |
حصلت على عنوان كمكافأة للّاعب مقابل أنشطته في اللعبة. |