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	زمانی که این بازیکن مخفی شده بود.