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.
Request
HTTP request
POST https://www.googleapis.com/games/v1/turnbasedmatches/matchId/rematch
Parameters
| 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. |
Authorization
This request requires authorization with the following scope:
| Scope |
|---|
https://www.googleapis.com/auth/games |
For more information, see the authentication and authorization page.
Request body
Do not supply a request body with this method.
Response
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.