Method: events.record

Registra um lote de mudanças no número de vezes que os eventos ocorreram para o usuário autenticado no momento do app.

Solicitação HTTP

POST https://games.googleapis.com/games/v1/events

Parâmetros de consulta

Parâmetros
language

string

O idioma preferencial a ser usado para strings retornadas por esse método.

Corpo da solicitação

O corpo da solicitação contém uma instância de EventsUpdates.

Corpo da resposta

Um recurso de atualização de período de evento.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

Todas as falhas em lote que ocorreram ao aplicar atualizações.
eventFailures[]

object (EventRecordFailure)

Todas as falhas na atualização de um evento específico.
playerEvents[]

object (PlayerEvent)

O status atual de todos os eventos atualizados

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Para mais informações, consulte a Visão geral do OAuth 2.0.

EventsUpdates

Um recurso de atualização de período de evento.

Representação JSON 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#eventRecordRequest.
requestId

string (int64 format)

O ID da solicitação usado para identificar essa tentativa de registro de eventos.
currentTimeMillis

string (int64 format)

A hora atual em que a atualização foi enviada, em milissegundos, desde 1970 UTC (época Unix).
timePeriods[]

object (EventPeriodUpdate)

Uma lista das atualizações de período de tempo feitas nesta solicitação.

EventPeriodUpdate

Um recurso de atualização de período de evento.

Representação JSON 
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Campos
timePeriod

object (EventPeriodRange)

O período coberto por essa atualização.
updates[]

object (EventUpdateRequest)

As atualizações feitas nesse período.
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#eventPeriodUpdate.

EventPeriodRange

Um período de evento.

Representação JSON 
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#eventPeriodRange.
periodStartMillis

string (int64 format)

O horário em que o período de atualização começa, em milissegundos, desde 1970 UTC (Era Unix).
periodEndMillis

string (int64 format)

A hora em que esse período de atualização termina, em milissegundos, desde 1970 UTC (época Unix).

EventUpdateRequest

Um recurso de atualização de período de evento.

Representação JSON 
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
Campos
definitionId

string

O ID do evento que está sendo modificado nesta atualização.
updateCount

string (int64 format)

O número de vezes que esse evento ocorreu no período.
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#eventUpdateRequest.

EventBatchRecordFailure

Um recurso de falha de atualização em lote.

Representação JSON 
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
Campos
range

object (EventPeriodRange)

O período que foi rejeitado. Vazio para uma falha em toda a solicitação.
failureCause

enum (EventFailureCause)

A causa da falha na atualização.
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#eventBatchRecordFailure.

EventFailureCause

Valores possíveis para uma causa de falha de evento.

Enumerações
TOO_LARGE Uma solicitação em lote foi emitida com mais eventos do que o permitido em um único lote.
TIME_PERIOD_EXPIRED Um lote foi enviado com dados muito antigos para serem registrados.
TIME_PERIOD_SHORT Um lote foi enviado com um período muito curto.
TIME_PERIOD_LONG Um lote foi enviado com um intervalo de tempo muito longo.
ALREADY_UPDATED Foi feita uma tentativa de registrar um lote de dados que já foi visto.
RECORD_RATE_HIGH Houve uma tentativa de registrar dados mais rapidamente do que o servidor vai aplicar as atualizações.

EventRecordFailure

Um recurso de falha de atualização de evento.

Representação JSON 
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
Campos
eventId

string

O ID do evento que não foi atualizado.
failureCause

enum (EventUpdateFailureCause)

A causa da falha na atualização.
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#eventRecordFailure.

EventUpdateFailureCause

Valores possíveis para a causa de uma falha na atualização de um evento.

Enumerações
NOT_FOUND Foi feita uma tentativa de definir um evento que não foi definido.
INVALID_UPDATE_VALUE Foi feita uma tentativa de incrementar um evento com um valor não positivo.