- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Pruébalo
Registra un lote de cambios en la cantidad de veces que se produjeron eventos para el usuario autenticado actualmente de esta aplicación.
Solicitud HTTP
POST https://games.googleapis.com/games/v1/events
Parámetros de consulta
Parámetros | |
---|---|
language |
El idioma preferido para las cadenas que muestra este método. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de EventsUpdates
.
Cuerpo de la respuesta
Un recurso de actualización del período de un evento.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "kind": string, "batchFailures": [ { object ( |
Campos | |
---|---|
kind |
Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija |
batchFailures[] |
Cualquier falla en todo el lote que se haya producido al aplicar las actualizaciones |
eventFailures[] |
Cualquier falla en la actualización de un evento en particular. |
playerEvents[] |
El estado actual de los eventos actualizados |
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Para obtener más información, consulta la descripción general de OAuth 2.0.
EventsUpdates
Un recurso de actualización del período de un evento.
Representación JSON |
---|
{
"kind": string,
"requestId": string,
"currentTimeMillis": string,
"timePeriods": [
{
object ( |
Campos | |
---|---|
kind |
Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija |
requestId |
El ID de solicitud que se usa para identificar este intento de registrar eventos. |
currentTimeMillis |
Indica la hora actual en la que se envió esta actualización, en milisegundos, desde 1970 UTC (époch Unix). |
timePeriods[] |
Una lista de las actualizaciones del período de tiempo que se realizan en esta solicitud. |
EventPeriodUpdate
Un recurso de actualización del período de un evento.
Representación JSON |
---|
{ "timePeriod": { object ( |
Campos | |
---|---|
timePeriod |
El período que cubre esta actualización. |
updates[] |
Las actualizaciones que se realizan para este período. |
kind |
Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija |
EventPeriodRange
Es un intervalo de tiempo del evento.
Representación JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Campos | |
---|---|
kind |
Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija |
periodStartMillis |
Indica la hora en que comienza este período de actualización, en milisegundos, a partir de 1970 UTC (époch Unix). |
periodEndMillis |
Indica la hora en la que finaliza este período de actualización, en milisegundos, a partir de 1970 UTC (époch Unix). |
EventUpdateRequest
Un recurso de actualización del período de un evento.
Representación JSON |
---|
{ "definitionId": string, "updateCount": string, "kind": string } |
Campos | |
---|---|
definitionId |
El ID del evento que se modificará en esta actualización. |
updateCount |
La cantidad de veces que ocurrió este evento durante este período. |
kind |
Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija |
EventBatchRecordFailure
Un recurso con errores de actualización por lotes.
Representación JSON |
---|
{ "range": { object ( |
Campos | |
---|---|
range |
El intervalo de tiempo que se rechazó. vacío para una falla en toda la solicitud. |
failureCause |
Es la causa de la falla de la actualización. |
kind |
Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija |
EventFailureCause
Valores posibles para una causa de falla de evento.
Enumeraciones | |
---|---|
TOO_LARGE |
Se emitió una solicitud por lotes con más eventos de los permitidos en un solo lote. |
TIME_PERIOD_EXPIRED |
Se envió un lote con datos muy lejanos en el pasado como para ser registrados. |
TIME_PERIOD_SHORT |
Se envió un lote con un intervalo de tiempo demasiado corto. |
TIME_PERIOD_LONG |
Se envió un lote con un intervalo de tiempo demasiado largo. |
ALREADY_UPDATED |
Se intentó registrar un lote de datos que ya se había visto. |
RECORD_RATE_HIGH |
Se intentó registrar los datos más rápido de lo que el servidor aplicará las actualizaciones. |
EventRecordFailure
Un recurso con errores en la actualización de eventos.
Representación JSON |
---|
{
"eventId": string,
"failureCause": enum ( |
Campos | |
---|---|
eventId |
El ID del evento que no se actualizó. |
failureCause |
Es la causa de la falla de la actualización. |
kind |
Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija |
EventUpdateFailureCause
Son los valores posibles de la causa de una falla en la actualización de un evento.
Enumeraciones | |
---|---|
NOT_FOUND |
Se intentó establecer un evento sin definir. |
INVALID_UPDATE_VALUE |
Se intentó aumentar un evento con un valor no positivo. |