- 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ébala
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 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 ( |
Campos | |
---|---|
kind |
Identifica de forma única el tipo de este recurso. El valor siempre es 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 |
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 ( |
Campos | |
---|---|
kind |
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija |
requestId |
El ID de solicitud que se usa para identificar este intento de grabar eventos. |
currentTimeMillis |
La hora actual en la que se envió esta actualización, en milisegundos, desde 1970 UTC (Époch Unix). |
timePeriods[] |
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 ( |
Campos | |
---|---|
timePeriod |
Es el período que abarca 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 siempre es la cadena fija |
EventPeriodRange
El intervalo de tiempo de un evento.
Representación JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Campos | |
---|---|
kind |
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija |
periodStartMillis |
Indica la hora a la que comienza este período de actualización, expresada en milisegundos, desde 1970 UTC (Época Unix). |
periodEndMillis |
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 |
El ID del evento que se modifica en esta actualización. |
updateCount |
La cantidad de veces que ocurrió este evento en este período. |
kind |
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija |
EventBatchRecordFailure
Un recurso de falla de actualización por lotes.
Representación JSON |
---|
{ "range": { object ( |
Campos | |
---|---|
range |
El intervalo de tiempo que se rechazó; vacío en el caso de una falla en toda la solicitud. |
failureCause |
La causa de la falla en la actualización. |
kind |
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija |
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 ( |
Campos | |
---|---|
eventId |
El ID del evento que no se actualizó. |
failureCause |
La causa de la falla en la actualización. |
kind |
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija |
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. |