Method: recall.gamesPlayerTokens
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
從所有與 PGS 玩家相關聯的要求遊戲中擷取喚回符記 (透過提供的喚回工作階段 ID 編碼)。這個 API 僅適用於具備有效的 PGS 玩家設定檔的使用者。
HTTP 要求
GET https://games.googleapis.com/games/v1/recall/gamesPlayerTokens/{sessionId}
路徑參數
參數 |
sessionId |
string
必要欄位。由伺服器產生的不透明字串,用於編碼所有必要資訊,識別特定 PGS 播放器 / Google 使用者和應用程式。
|
查詢參數
參數 |
applicationIds[] |
string
必要欄位。Google Play 開發人員控制台中的遊戲應用程式 ID,用來傳回遊戲的限定範圍 ID。
|
回應主體
喚回度.gamesPlayerTokens 遠端程序呼叫 (RPC) 傳回的喚回符記資料清單
如果成功,回應主體會含有以下結構的資料:
欄位 |
gamePlayerTokens[] |
object (GamePlayerToken )
要求的應用程式以及玩家的喚回符記。如果玩家沒有應用程式的喚回符記,該應用程式就不會納入回應。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/androidpublisher
詳情請參閱 OAuth 2.0 總覽。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[null,null,["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],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)."]]