Method: events.record

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

string

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 (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#eventUpdateResponse.

batchFailures[]

object (EventBatchRecordFailure)

Cualquier falla en todo el lote que se haya producido al aplicar las actualizaciones

eventFailures[]

object (EventRecordFailure)

Cualquier falla en la actualización de un evento en particular.

playerEvents[]

object (PlayerEvent)

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 (EventPeriodUpdate)
    }
  ]
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#eventRecordRequest.

requestId

string (int64 format)

El ID de solicitud que se usa para identificar este intento de registrar eventos.

currentTimeMillis

string (int64 format)

Indica la hora actual en la que se envió esta actualización, en milisegundos, desde 1970 UTC (époch Unix).

timePeriods[]

object (EventPeriodUpdate)

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 (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Campos
timePeriod

object (EventPeriodRange)

El período que cubre esta actualización.

updates[]

object (EventUpdateRequest)

Las actualizaciones que se realizan para este período.

kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#eventPeriodUpdate.

EventPeriodRange

Es un intervalo de tiempo del evento.

Representación JSON
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#eventPeriodRange.

periodStartMillis

string (int64 format)

Indica la hora en que comienza este período de actualización, en milisegundos, a partir de 1970 UTC (époch Unix).

periodEndMillis

string (int64 format)

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

string

El ID del evento que se modificará en esta actualización.

updateCount

string (int64 format)

La cantidad de veces que ocurrió este evento durante este período.

kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#eventUpdateRequest.

EventBatchRecordFailure

Un recurso con errores de actualización por lotes.

Representación JSON
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
Campos
range

object (EventPeriodRange)

El intervalo de tiempo que se rechazó; vacío para una falla en toda la solicitud.

failureCause

enum (EventFailureCause)

Es la causa de la falla de la actualización.

kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#eventBatchRecordFailure.

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 demasiado lejanos en el pasado para registrarlos.
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 (EventUpdateFailureCause),
  "kind": string
}
Campos
eventId

string

El ID del evento que no se actualizó.

failureCause

enum (EventUpdateFailureCause)

Es la causa de la falla de la actualización.

kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#eventRecordFailure.

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.