Google Play Game Services . recall

Instance Methods

close()

Close httplib2 connections.

lastTokenFromAllDeveloperGames(sessionId, x__xgafv=None)

Retrieve the last Recall token from all developer games that is 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.

linkPersona(body=None, x__xgafv=None)

Associate the PGS Player principal encoded in the provided recall session id with an in-game account

resetPersona(body=None, x__xgafv=None)

Delete all Recall tokens linking the given persona to any player (with or without a profile).

retrieveTokens(sessionId, x__xgafv=None)

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.

unlinkPersona(body=None, x__xgafv=None)

Delete a Recall token linking the PGS Player principal identified by the Recall session and an in-game account identified either by the 'persona' or by the token value.

Method Details

close()
Close httplib2 connections.
lastTokenFromAllDeveloperGames(sessionId, x__xgafv=None)
Retrieve the last Recall token from all developer games that is 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.

Args:
  sessionId: string, Required. Opaque server-generated string that encodes all the necessary information to identify the PGS player / Google user and application. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Recall token data returned from for the RetrieveDeveloperGamesLastPlayerToken RPC
  "token": { # Recall token data returned from RetrievePlayerTokens RPC # The recall token associated with the requested PGS Player principal. It can be unset if there is no recall token associated with the requested principal.
    "expireTime": "A String", # Optional. Optional expiration time of the token
    "multiPlayerPersona": True or False, # Required. Whether the persona identified by the token is linked to multiple PGS Players
    "token": "A String", # Required. Value of the Recall token as it is provided by the client via LinkPersona RPC
  },
}
linkPersona(body=None, x__xgafv=None)
Associate the PGS Player principal encoded in the provided recall session id with an in-game account

Args:
  body: object, The request body.
    The object takes the form of:

{ # Request to link an in-game account with a PGS principal (encoded in the session id).
  "cardinalityConstraint": "A String", # Required. Cardinality constraint to observe when linking a persona to a player in the scope of a game.
  "conflictingLinksResolutionPolicy": "A String", # Required. Resolution policy to apply when the linking of a persona to a player would result in violating the specified cardinality constraint.
  "expireTime": "A String", # Input only. Optional expiration time.
  "persona": "A String", # Required. Stable identifier of the in-game account. Please refrain from re-using the same persona for different games.
  "sessionId": "A String", # Required. Opaque server-generated string that encodes all the necessary information to identify the PGS player / Google user and application.
  "token": "A String", # Required. Value of the token to create. Opaque to Play Games and assumed to be non-stable (encrypted with key rotation).
  "ttl": "A String", # Input only. Optional time-to-live.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Outcome of a persona linking attempt.
  "state": "A String", # Output only. State of a persona linking attempt.
}
resetPersona(body=None, x__xgafv=None)
Delete all Recall tokens linking the given persona to any player (with or without a profile).

Args:
  body: object, The request body.
    The object takes the form of:

{ # Request to remove all Recall tokens associated with a persona for an app.
  "persona": "A String", # Value of the 'persona' field as it was provided by the client in LinkPersona RPC
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response for the ResetPersona RPC
  "unlinked": True or False, # Required. Whether any tokens were unlinked as a result of this request.
}
retrieveTokens(sessionId, x__xgafv=None)
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.

Args:
  sessionId: string, Required. Opaque server-generated string that encodes all the necessary information to identify the PGS player / Google user and application. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response for the RetrievePlayerTokens RPC
  "tokens": [ # Required. Recall tokens associated with the requested PGS Player principal
    { # Recall token data returned from RetrievePlayerTokens RPC
      "expireTime": "A String", # Optional. Optional expiration time of the token
      "multiPlayerPersona": True or False, # Required. Whether the persona identified by the token is linked to multiple PGS Players
      "token": "A String", # Required. Value of the Recall token as it is provided by the client via LinkPersona RPC
    },
  ],
}
unlinkPersona(body=None, x__xgafv=None)
Delete a Recall token linking the PGS Player principal identified by the Recall session and an in-game account identified either by the 'persona' or by the token value.

Args:
  body: object, The request body.
    The object takes the form of:

{ # Request to remove a Recall token linking PGS principal and an in-game account
  "persona": "A String", # Value of the 'persona' field as it was provided by the client in LinkPersona RPC
  "sessionId": "A String", # Required. Opaque server-generated string that encodes all the necessary information to identify the PGS player / Google user and application.
  "token": "A String", # Value of the Recall token as it was provided by the client in LinkPersona RPC
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response for the UnlinkPersona RPC
  "unlinked": True or False, # Required. Whether a Recall token specified by the request was deleted. Can be 'false' when there were no Recall tokens satisfied the criteria from the request.
}