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 | لیستی از بازیکنانی که دوستان کاربر هستند را به ترتیب حروف الفبا بازیابی کنید. |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: players.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPlayersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Collection](#Collection)\n- [Try it!](#try-it)\n\nGet the collection of players for the currently authenticated user.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/me/players/{collection}`\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------|\n| `collection` | `enum (`[Collection](/games/services/web/api/rest/v1/players/list#Collection)`)` Collection of players being retrieved |\n\n### Query parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `maxResults` | `integer` The maximum number of player resources to return in the response, used for paging. For any response, the actual number of player resources returned may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA third party player list response.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"items\": [ { object (/games/services/web/api/rest/v1/players#Player) } ] } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. |\n| `items[]` | `object (`[Player](/games/services/web/api/rest/v1/players#Player)`)` The players. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nCollection\n----------\n\n| Enums ||\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `CONNECTED` | Retrieve a list of players that are also playing this game in reverse chronological order. | The CONNECTED collection of G+ friends is deprecated, use the FRIENDS_ALL collection instead. |\n| `VISIBLE` | Retrieve a list of players in the user's social graph that are visible to this game. | The VISIBLE collection of G+ friends is deprecated, use the FRIENDS_ALL collection instead. |\n| `FRIENDS_ALL` | Retrieve a list of players who are friends of the user in alphabetical order. |"]]
