TurnBasedMatches: rematch

Create a rematch of a match that was previously completed, with the same participants. This can be called by only one player on a match still in their list; the player must have called Finish first. Returns the newly created match; it will be the caller's turn. Try it now.


HTTP request

POST https://www.googleapis.com/games/v1/turnbasedmatches/matchId/rematch


Parameter name Value Description
Path parameters
matchId string The ID of the match.
Optional query parameters
language string The preferred language to use for strings returned by this method.
requestId long A randomly generated numeric ID for each request specified by the caller. This number is used at the server to ensure that the request is handled correctly across retries.


This request requires authorization with the following scope:


For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.


If successful, this method returns a response body with the following structure:

  "kind": "games#turnBasedMatchRematch",
  "rematch": turnBasedMatches Resource,
  "previousMatch": turnBasedMatches Resource
Property name Value Description Notes
kind string Uniquely identifies the type of this resource. Value is always the fixed string games#turnBasedMatchRematch.
rematch nested object The newly created match; a rematch of the old match with the same participants.
previousMatch nested object The old match that the rematch was created from; will be updated such that the rematchId field will point at the new match.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.