Method: recall.gamesPlayerTokens
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מאחזרים את אסימוני Recall מכל המשחקים המבוקשים שמשויכים לנגן PGS שמקודד במזהה סשן הריקול שסופק. ה-API זמין רק למשתמשים שיש להם פרופיל פעיל ב-PGS Player.
בקשת HTTP
GET https://games.googleapis.com/games/v1/recall/gamesPlayerTokens/{sessionId}
פרמטרים של נתיב
| פרמטרים |
sessionId |
string
חובה. מחרוזת אטומה שנוצרה על ידי השרת שמקודדת את כל המידע הנדרש לזיהוי הנגן של PGS / המשתמש של Google והאפליקציה.
|
פרמטרים של שאילתה
| פרמטרים |
applicationIds[] |
string
חובה. מזהי האפליקציות מ-Google Play Developer Console של המשחקים שיש להחזיר עבורם מזהים בהיקף.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
רשימה של נתונים של אסימוני זיכרון שהוחזרו מה-RPC.gamesPlayerTokens
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| שדות |
gamePlayerTokens[] |
object (GamePlayerToken)
האפליקציות המבוקשות יחד עם אסימוני Recall של הנגן. אם אין לנגן אסימוני Recall לאפליקציה, האפליקציה לא תיכלל בתשובה.
|
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/androidpublisher
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Method: recall.gamesPlayerTokens\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.RetrieveGamesPlayerTokensResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieve the Recall tokens from all requested games that is associated with the PGS Player encoded in the provided recall session id. The API is only available for users that have an active PGS Player profile.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/recall/gamesPlayerTokens/{sessionId}`\n\n### Path parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `sessionId` | `string` Required. Opaque server-generated string that encodes all the necessary information to identify the PGS player / Google user and application. |\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\nA list of recall token data returned from the recall.gamesPlayerTokens RPC\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------|\n| ``` { \"gamePlayerTokens\": [ { object (/games/services/web/api/rest/v1/GamePlayerToken) } ] } ``` |\n\n| Fields ||\n|----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `gamePlayerTokens[]` | `object (`[GamePlayerToken](/games/services/web/api/rest/v1/GamePlayerToken)`)` The requested applications along with the recall tokens for the player. If the player does not have recall tokens for an application, that application is not included in the response. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
