Google Play Game Services . recall

close()

Close httplib2 connections.

gamesPlayerTokens(sessionId, applicationIds=None, x__xgafv=None)

Retrieve 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.

Args:
  sessionId: string, Required. Opaque server-generated string that encodes all the necessary information to identify the PGS player / Google user and application. (required)
  applicationIds: string, Required. The application IDs from the Google Play developer console for the games to return scoped ids for. (repeated)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A list of recall token data returned from the RetrieveGamesPlayerTokens RPC
  "gamePlayerTokens": [ # 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.
    { # Recall tokens for a game.
      "applicationId": "A String", # The application that this player identifier is for.
      "recallToken": { # Recall token data returned from RetrievePlayerTokens RPC # Recall token data.
        "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
      },
    },
  ],
}

lastTokenFromAllDeveloperGames(sessionId, x__xgafv=None)

Retrieve the last Recall token from all developer games that is associated with the PGS Player 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
  "gamePlayerToken": { # Recall tokens for a game. # 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.
    "applicationId": "A String", # The application that this player identifier is for.
    "recallToken": { # Recall token data returned from RetrievePlayerTokens RPC # Recall token data.
      "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 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.
}