Applications: listHidden

نیاز به مجوز دارد

لیستی از بازیکنان پنهان شده از برنامه داده شده را دریافت کنید. این روش فقط برای حساب های کاربری کنسول توسعه دهنده شما در دسترس است.

درخواست کنید

درخواست HTTP

GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden

پارامترها

نام پارامتر ارزش توضیحات
پارامترهای مسیر
applicationId string شناسه برنامه از کنسول Google Play.
پارامترهای پرس و جو اختیاری
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 Epoch UTC.
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 زمانی که این بازیکن مخفی شده بود.