Method: players.list

مجموعه ای از بازیکنان را برای کاربر تأیید شده فعلی دریافت کنید.

درخواست HTTP

GET https://games.googleapis.com/games/v1/players/me/players/{collection}

پارامترهای مسیر

مولفه های
collection

enum ( Collection )

مجموعه ای از بازیکنان در حال بازیابی

پارامترهای پرس و جو

مولفه های
language

string

زبان ترجیحی برای استفاده برای رشته های برگردانده شده توسط این روش.

maxResults

integer

حداکثر تعداد منابع پخش کننده برای بازگشت در پاسخ، استفاده شده برای صفحه بندی. برای هر پاسخی، ممکن است تعداد واقعی منابع بازیکن بازگردانده شده کمتر از maxResults مشخص شده باشد.

pageToken

string

توکن با درخواست قبلی بازگردانده شد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ لیست پخش کننده شخص ثالث.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (Player)
    }
  ]
}
زمینه های
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#playerListResponse .

nextPageToken

string

نشانه مربوط به صفحه بعدی نتایج.

items[]

object ( Player )

بازیکنان.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

مجموعه

Enums
CONNECTED

لیستی از بازیکنانی را که در حال انجام این بازی نیز هستند به ترتیب زمانی معکوس بازیابی کنید.

VISIBLE

لیستی از بازیکنان موجود در نمودار اجتماعی کاربر که برای این بازی قابل مشاهده است، بازیابی کنید.

FRIENDS_ALL لیستی از بازیکنانی که دوستان کاربر هستند را به ترتیب حروف الفبا بازیابی کنید.