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 usar en las cadenas que muestra este método.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye 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 siempre es 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

Permisos de autorización

Se necesita uno de los siguientes alcances 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 siempre es la cadena fija games#eventRecordRequest.
requestId

string (int64 format)

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

string (int64 format)

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 de período 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)

Es el período que abarca 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 siempre es la cadena fija games#eventPeriodUpdate.

EventPeriodRange

El intervalo de tiempo de un evento.

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

string

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

string (int64 format)

Indica la hora a la que comienza este período de actualización, expresada en milisegundos, desde 1970 UTC (Época Unix).
periodEndMillis

string (int64 format)

Indica la hora a la que finaliza este período de actualización, en milisegundos, desde 1970 UTC (Época 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 modifica en esta actualización.
updateCount

string (int64 format)

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

string

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

EventBatchRecordFailure

Un recurso de falla 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 en el caso de una falla en toda la solicitud.
failureCause

enum (EventFailureCause)

La causa de la falla en la actualización.
kind

string

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

EventFailureCause

Los valores posibles para la causa de una falla de un evento.

Enumeradores
TOO_LARGE Se emitió una solicitud por lotes con más eventos de los que se permiten en un solo lote.
TIME_PERIOD_EXPIRED Se envió un lote con datos que son muy lejanos en el pasado como 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 datos más rápido de lo que el servidor aplicará las actualizaciones.

EventRecordFailure

Un recurso de falla de 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)

La causa de la falla en la actualización.
kind

string

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

EventUpdateFailureCause

Los valores posibles para la causa de una falla en la actualización de un evento.

Enumeradores
NOT_FOUND Se intentó establecer un evento que no se definió.
INVALID_UPDATE_VALUE Se intentó incrementar un evento en un valor no positivo.