Method: events.record

Registra un lote de cambios en la cantidad de veces que ocurrieron 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 strings 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 del 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 exclusiva el tipo de este recurso. El valor es siempre la string 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 la 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.

Actualizaciones de eventos

Un recurso de actualización del período del evento.

Representación JSON 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
Campos
kind

string

Identifica de forma exclusiva el tipo de este recurso. El valor es siempre la string 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)

La hora actual en la que se envió esta actualización, en milisegundos, desde 1970 UTC (época Unix).
timePeriods[]

object (EventPeriodUpdate)

Una lista de las actualizaciones del período que se realizan en esta solicitud.

Actualización de Período de Eventos

Un recurso de actualización del período del evento.

Representación JSON 
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Campos
timePeriod

object (EventPeriodRange)

Indica el período que abarca esta actualización.
updates[]

object (EventUpdateRequest)

Las actualizaciones que se realizarán para este período.
kind

string

Identifica de forma exclusiva el tipo de este recurso. El valor es siempre la string fija games#eventPeriodUpdate.

Rango de eventos

Es el intervalo de tiempo del período de un evento.

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

string

Identifica de forma exclusiva el tipo de este recurso. El valor es siempre la string fija games#eventPeriodRange.
periodStartMillis

string (int64 format)

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

string (int64 format)

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 del 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)

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

string

Identifica de forma exclusiva el tipo de este recurso. El valor es siempre la string fija games#eventUpdateRequest.

Error de EventBatchRecord

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 para una falla en toda la solicitud.
failureCause

enum (EventFailureCause)

La causa del error de actualización.
kind

string

Identifica de forma exclusiva el tipo de este recurso. El valor es siempre la string fija games#eventBatchRecordFailure.

EventFailureCause

Los valores posibles para una causa de falla de 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 muy lejanos 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.

Error de registro de evento

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 del error de actualización.
kind

string

Identifica de forma exclusiva el tipo de este recurso. El valor es siempre la string fija games#eventRecordFailure.

EventUpdateFailureCause

Valores posibles para la causa de una falla de actualización de evento.

Enumeradores
NOT_FOUND Se intentó configurar un evento que no se definió.
INVALID_UPDATE_VALUE Se intentó incrementar un evento según un valor no positivo.