Applications: listHidden

يجب تقديم تفويض

يمكنك الحصول على قائمة باللاعبين المخفيين من التطبيق المعني. لا تتوفّر هذه الطريقة إلا لحسابات المستخدمين في وحدة تحكُّم المطوِّر.

الطلب

طلب 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	حصلت على عنوان كمكافأة للّاعب مقابل أنشطته في اللعبة.
items[].hiddenTimeMillis	long	الوقت الذي كان فيه هذا اللاعب مخفيًا