Method: players.getMultipleApplicationPlayerIds
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
קבלת מזהי הנגן של האפליקציות של השחקן המאומת בכל המשחקים המבוקשים על ידי אותו מפתח כמו אפליקציית הקריאה. הפעולה הזו תחזיר מזהים רק עבור שחקנים שיש להם מזהה בפועל (היקף או אחר) עם המשחק הזה.
בקשת HTTP
GET https://games.googleapis.com/games/v1/players/me/multipleApplicationPlayerIds
פרמטרים של שאילתה
| פרמטרים |
applicationIds[] |
string
חובה. מזהי האפליקציות מ-Google Play Developer Console של המשחקים שיש להחזיר עבורם מזהים בהיקף.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הודעת תגובה ל- Player.getMultipleApplicationPlayerIds rpc.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| שדות |
playerIds[] |
object (ApplicationPlayerId)
פלט בלבד. האפליקציות המבוקשות יחד עם המזהים ההיקפיים של הנגן, אם לשחקן יש מזהה עבור האפליקציה. אם לא, האפליקציה לא תיכלל בתשובה.
|
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
ApplicationPlayerId
מזהה הנגן הראשי בהיקף של אפליקציה.
| ייצוג JSON |
{
"applicationId": string,
"playerId": string
} |
| שדות |
applicationId |
string
האפליקציה שמזהה הנגן הזה מיועד לה.
|
playerId |
string
מזהה הנגן של האפליקציה.
|
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Method: players.getMultipleApplicationPlayerIds\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.GetMultipleApplicationPlayerIdsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ApplicationPlayerId](#ApplicationPlayerId)\n - [JSON representation](#ApplicationPlayerId.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGet the application player ids for the currently authenticated player across all requested games by the same developer as the calling application. This will only return ids for players that actually have an id (scoped or otherwise) with that game.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/me/multipleApplicationPlayerIds`\n\n### Query parameters\n\n| Parameters ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------|\n| `applicationIds[]` | `string` Required. The application IDs from the Google Play developer console for the games to return scoped ids for. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for players.getMultipleApplicationPlayerIds rpc.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"playerIds\": [ { object (/games/services/web/api/rest/v1/players/getMultipleApplicationPlayerIds#ApplicationPlayerId) } ] } ``` |\n\n| Fields ||\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `playerIds[]` | `object (`[ApplicationPlayerId](/games/services/web/api/rest/v1/players/getMultipleApplicationPlayerIds#ApplicationPlayerId)`)` Output only. The requested applications along with the scoped ids for tha player, if that player has an id for the application. If not, the application is not included in the response. |\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\nApplicationPlayerId\n-------------------\n\nPrimary scoped player identifier for an application.\n\n| JSON representation |\n|---------------------------------------------------------|\n| ``` { \"applicationId\": string, \"playerId\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------|\n| `applicationId` | `string` The application that this player identifier is for. |\n| `playerId` | `string` The player identifier for the application. |"]]
