Google Play Developer Events API
The Events API from Google Play Developer — 2 operation(s) for events.
The Events API from Google Play Developer — 2 operation(s) for events.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/google-play:google-play-events-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Google Play Games Services Events API
version: v1
description: Generated from Google's published Discovery document for Google Play Games Services API (games v1, revision 20261106). 3 operation(s).
contact:
name: Google
url: https://developers.google.com/
termsOfService: https://developers.google.com/terms
servers:
- url: https://games.googleapis.com
tags:
- name: Events
paths:
/games/v1/eventDefinitions:
get:
operationId: games.events.listDefinitions
summary: List definitions events
description: Returns a list of the event definitions in this application.
parameters:
- name: language
in: query
required: false
description: The preferred language to use for strings returned by this method.
schema:
type: string
- name: maxResults
in: query
required: false
description: The maximum number of event definitions to return in the response, used for paging. For any response, the actual number of event definitions to return may be less than the specified `maxResults`.
schema:
format: int32
type: integer
- name: pageToken
in: query
required: false
description: The token returned by the previous request.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/EventDefinitionListResponse'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/games
- apiKey: []
tags:
- Events
/games/v1/events:
post:
operationId: games.events.record
summary: Record events
description: Records a batch of changes to the number of times events have occurred for the currently authenticated user of this application.
parameters:
- name: language
in: query
required: false
description: The preferred language to use for strings returned by this method.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EventRecordRequest'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/EventUpdateResponse'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/games
- apiKey: []
tags:
- Events
get:
operationId: games.events.listByPlayer
summary: List by player events
description: Returns a list showing the current progress on events in this application for the currently authenticated user.
parameters:
- name: language
in: query
required: false
description: The preferred language to use for strings returned by this method.
schema:
type: string
- name: maxResults
in: query
required: false
description: The maximum number of events to return in the response, used for paging. For any response, the actual number of events to return may be less than the specified maxResults.
schema:
format: int32
type: integer
- name: pageToken
in: query
required: false
description: The token returned by the previous request.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/PlayerEventListResponse'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/games
- apiKey: []
tags:
- Events
components:
schemas:
EventUpdateRequest:
properties:
definitionId:
description: The ID of the event being modified in this update.
type: string
kind:
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventUpdateRequest`.
type: string
updateCount:
format: int64
type: string
description: The number of times this event occurred in this time period.
type: object
description: An event period update resource.
EventRecordRequest:
description: An event period update resource.
type: object
properties:
kind:
type: string
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventRecordRequest`.
requestId:
type: string
format: int64
description: The request ID used to identify this attempt to record events.
currentTimeMillis:
type: string
format: int64
description: The current time when this update was sent, in milliseconds, since 1970 UTC (Unix Epoch).
timePeriods:
type: array
items:
$ref: '#/components/schemas/EventPeriodUpdate'
description: A list of the time period updates being made in this request.
EventRecordFailure:
type: object
properties:
kind:
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventRecordFailure`.
type: string
failureCause:
description: The cause for the update failure.
type: string
enum:
- NOT_FOUND
- INVALID_UPDATE_VALUE
eventId:
description: The ID of the event that was not updated.
type: string
description: An event update failure resource.
EventPeriodRange:
description: An event period time range.
type: object
properties:
periodEndMillis:
description: The time when this update period ends, in millis, since 1970 UTC (Unix Epoch).
format: int64
type: string
kind:
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventPeriodRange`.
type: string
periodStartMillis:
format: int64
description: The time when this update period begins, in millis, since 1970 UTC (Unix Epoch).
type: string
EventPeriodUpdate:
type: object
description: An event period update resource.
properties:
kind:
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventPeriodUpdate`.
type: string
updates:
items:
$ref: '#/components/schemas/EventUpdateRequest'
type: array
description: The updates being made for this time period.
timePeriod:
$ref: '#/components/schemas/EventPeriodRange'
description: The time period being covered by this update.
EventBatchRecordFailure:
properties:
range:
$ref: '#/components/schemas/EventPeriodRange'
description: The time range which was rejected; empty for a request-wide failure.
kind:
type: string
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventBatchRecordFailure`.
failureCause:
type: string
enum:
- TOO_LARGE
- TIME_PERIOD_EXPIRED
- TIME_PERIOD_SHORT
- TIME_PERIOD_LONG
- ALREADY_UPDATED
- RECORD_RATE_HIGH
description: The cause for the update failure.
description: A batch update failure resource.
type: object
EventDefinitionListResponse:
properties:
kind:
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventDefinitionListResponse`.
type: string
items:
description: The event definitions.
type: array
items:
$ref: '#/components/schemas/EventDefinition'
nextPageToken:
description: The pagination token for the next page of results.
type: string
type: object
description: A ListDefinitions response.
PlayerEventListResponse:
description: A ListByPlayer response.
properties:
nextPageToken:
description: The pagination token for the next page of results.
type: string
kind:
type: string
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#playerEventListResponse`.
items:
description: The player events.
type: array
items:
$ref: '#/components/schemas/PlayerEvent'
type: object
GoogleRpcError:
type: object
description: The error envelope every Google API returns.
properties:
error:
type: object
properties:
code:
type: integer
message:
type: string
status:
type: string
details:
type: array
items:
type: object
PlayerEvent:
description: An event status resource.
properties:
playerId:
type: string
description: The ID of the player.
kind:
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#playerEvent`.
type: string
numEvents:
description: The current number of times this event has occurred.
type: string
format: int64
formattedNumEvents:
type: string
description: The current number of times this event has occurred, as a string. The formatting of this string depends on the configuration of your event in the Play Games Developer Console.
definitionId:
type: string
description: The ID of the event definition.
type: object
EventChild:
type: object
properties:
childId:
type: string
description: The ID of the child event.
kind:
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventChild`.
type: string
description: An event child relationship resource.
EventUpdateResponse:
description: An event period update resource.
properties:
eventFailures:
items:
$ref: '#/components/schemas/EventRecordFailure'
type: array
description: Any failures updating a particular event.
kind:
type: string
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventUpdateResponse`.
playerEvents:
description: The current status of any updated events
items:
$ref: '#/components/schemas/PlayerEvent'
type: array
batchFailures:
items:
$ref: '#/components/schemas/EventBatchRecordFailure'
type: array
description: Any batch-wide failures which occurred applying updates.
type: object
EventDefinition:
description: An event definition resource.
type: object
properties:
isDefaultImageUrl:
type: boolean
description: Indicates whether the icon image being returned is a default image, or is game-provided.
imageUrl:
type: string
description: The base URL for the image that represents the event.
kind:
type: string
description: Uniquely identifies the type of this resource. Value is always the fixed string `games#eventDefinition`.
displayName:
description: The name to display for the event.
type: string
description:
type: string
description: Description of what this event represents.
id:
description: The ID of the event.
type: string
visibility:
type: string
description: The visibility of event being tracked in this definition.
enum:
- REVEALED
- HIDDEN
childEvents:
type: array
items:
$ref: '#/components/schemas/EventChild'
description: A list of events that are a child of this event.
securitySchemes:
apiKey:
type: apiKey
in: query
name: key
description: API key; accepted by methods that do not need user data.
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://accounts.google.com/o/oauth2/auth
tokenUrl: https://oauth2.googleapis.com/token
scopes:
https://www.googleapis.com/auth/games: Create, edit, and delete your Google Play Games activity
https://www.googleapis.com/auth/androidpublisher: View and manage your Google Play Developer account
https://www.googleapis.com/auth/drive.appdata: See, create, and delete its own configuration data in your Google Drive
externalDocs:
url: https://developers.google.com/games/
x-provenance:
method: harvested
publisher: Google
source: https://games.googleapis.com/$discovery/rest?version=v1
note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261106)