Applications: listHidden

يتطلّب تفويضًا

يمكنك إخفاء قائمة المشغّلات من التطبيق المحدّد. لا تتوفَّر هذه الطريقة إلا لحسابات المستخدمين في 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 هو لقب اللاعب كمكافأة مقابل أنشطته في اللعبة.
items[].hiddenTimeMillis long الوقت الذي تم فيه إخفاء هذا اللاعب