TurnBasedMatches: sync

Returns turn-based matches the player is or was involved in that changed since the last sync call, with the least recent changes coming first. Matches that should be removed from the local cache will have a status of MATCH_DELETED. Try it now.

Request

HTTP request

GET https://www.googleapis.com/games/v1/turnbasedmatches/sync

Parameters

Parameter name	Value	Description
Optional query parameters
`includeMatchData`	`boolean`	True if match data should be returned in the response. Note that not all data will necessarily be returned if include_match_data is true; the server may decide to only return data for some of the matches to limit download size for the client. The remainder of the data for these matches will be retrievable on request.
`language`	`string`	The preferred language to use for strings returned by this method.
`maxCompletedMatches`	`integer`	The maximum number of completed or canceled matches to return in the response. If not set, all matches returned could be completed or canceled. Acceptable values are `0` to `500`, inclusive.
`maxResults`	`integer`	The maximum number of matches to return in the response, used for paging. For any response, the actual number of matches to return may be less than the specified maxResults. Acceptable values are `1` to `500`, inclusive.
`pageToken`	`string`	The token returned by the previous request.

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#turnBasedMatchSync",
  "nextPageToken": string,
  "moreAvailable": boolean,
  "items": [
    turnBasedMatches Resource
  ]
}

Property name	Value	Description
`kind`	`string`	Uniquely identifies the type of this resource. Value is always the fixed string `games#turnBasedMatchSync`.
`nextPageToken`	`string`	The pagination token for the next page of results.
`moreAvailable`	`boolean`	True if there were more matches available to fetch at the time the response was generated (which were not returned due to page size limits.)
`items[]`	`list`	The matches.

Try it!

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