Method: recall.retrieveTokens

Retrieve all Recall tokens associated with the PGS Player principal encoded in the provided recall session id. The API is only available for users that have active PGS Player profile.

HTTP request

GET https://games.googleapis.com/games/v1/recall/tokens/{sessionId}

Path parameters

Parameters
sessionId

string

Required. Opaque server-generated string that encodes all the necessary information to identify the PGS player / Google user and application.

Request body

The request body must be empty.

Response body

Response for the recall.retrieveTokens RPC

If successful, the response body contains data with the following structure:

JSON representation 
{
  "tokens": [
    {
      object (RecallToken)
    }
  ]
}
Fields
tokens[]

object (RecallToken)

Required. Recall tokens associated with the requested PGS Player principal

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/androidpublisher

For more information, see the OAuth 2.0 Overview.

RecallToken

Recall token data returned from recall.retrieveTokens RPC

JSON representation 
{
  "token": string,
  "multiPlayerPersona": boolean,
  "expireTime": string
}
Fields
token

string

Required. Value of the Recall token as it is provided by the client via recall.linkPersona RPC
multiPlayerPersona

boolean

Required. Whether the persona identified by the token is linked to multiple PGS Players
expireTime

string (Timestamp format)

Optional. Optional expiration time of the token

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".