Method: events.record

Registra um lote de alterações no número de vezes que os eventos ocorreram para o usuário atualmente autenticado deste aplicativo.

Solicitação HTTP

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

Parâmetros de consulta

Parâmetros
language

string

O idioma preferido a ser usado para strings retornadas por este 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 do período do 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 todo o lote que ocorreram ao aplicar atualizações.
eventFailures[]

object (EventRecordFailure)

Qualquer falha ao atualizar um evento específico.
playerEvents[]

object (PlayerEvent)

O status atual de todos os eventos atualizados

Escopos de autorização

Requer um dos seguintes escopos de 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 do período do 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 registrar eventos.
currentTimeMillis

string (int64 format)

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

object (EventPeriodUpdate)

Uma lista das atualizações de período que estão sendo feitas na solicitação.

EventPeriodUpdate

Um recurso de atualização do período do 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 estão sendo feitas para esse período.
kind

string

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

EventPeriodRange

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

A hora em que o período de atualização começa, em milissegundos, desde 1970 UTC (Época Unix).
periodEndMillis

string (int64 format)

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

EventUpdateRequest

Um recurso de atualização do período do 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 o evento ocorreu nesse 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 de 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 em um evento.

Enums
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 distantes 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 período muito longo.
ALREADY_UPDATED Houve uma tentativa de registrar um lote de dados que já foi visto.
RECORD_RATE_HIGH Houve uma tentativa de gravar dados mais rápido do que o servidor aplicará as atualizações.

EventRecordFailure

Um recurso de falha na 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 de 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.

Enums
NOT_FOUND Houve 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.