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

Es el idioma preferido para usar en 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 siempre es la cadena fija games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

Cualquier error general del lote que se haya producido cuando se aplicaron las actualizaciones
eventFailures[]

object (EventRecordFailure)

Cualquier error que se produzca al actualizar un evento en particular
playerEvents[]

object (PlayerEvent)

El estado actual de los eventos actualizados

Permisos de autorización

Se requiere 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 siempre es 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)

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

object (EventPeriodUpdate)

Es una lista de los períodos que se actualizarán 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 durante este período
kind

string

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

EventPeriodRange

Es un intervalo de tiempo de un período 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 siempre es la cadena fija games#eventPeriodRange.
periodStartMillis

string (int64 format)

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

string (int64 format)

La hora en 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

Es el ID del evento que se modifica en esta actualización.
updateCount

string (int64 format)

Es 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 error de actualización por lotes.

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

object (EventPeriodRange)

Es el intervalo que se rechazó. Si se produce un error en toda la solicitud, este campo estará vacío.
failureCause

enum (EventFailureCause)

La causa del error de actualización.
kind

string

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

EventFailureCause

Valores posibles para una causa de falla de evento.

Enums
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 antiguos para registrarlos.
TIME_PERIOD_SHORT Se envió un lote con un período demasiado corto.
TIME_PERIOD_LONG Se envió un lote con un período 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 error 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 única el tipo de este recurso. El valor siempre es la cadena fija games#eventRecordFailure.

EventUpdateFailureCause

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

Enums
NOT_FOUND Se intentó establecer un evento que no estaba definido.
INVALID_UPDATE_VALUE Se intentó incrementar un evento en un valor no positivo.