Method: events.record

Записывает пакет изменений количества событий, произошедших для текущего аутентифицированного пользователя этого приложения.

HTTP-запрос

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

Параметры запроса

Параметры
language

string

Предпочтительный язык для строк, возвращаемых этим методом.

Тело запроса

Тело запроса содержит экземпляр EventsUpdates .

Тело ответа

Ресурс обновления периода событий.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Поля
kind

string

Уникально определяет тип этого ресурса. Значением всегда является фиксированная строка games#eventUpdateResponse .

batchFailures[]

object ( EventBatchRecordFailure )

Любые общепакетные сбои, возникшие при применении обновлений.

eventFailures[]

object ( EventRecordFailure )

Любые сбои при обновлении определенного события.

playerEvents[]

object ( PlayerEvent )

Текущий статус любых обновленных событий

Области авторизации

Требуется одна из следующих областей OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

СобытияОбновления

Ресурс обновления периода событий.

JSON-представление
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
Поля
kind

string

Уникально определяет тип этого ресурса. Значением всегда является фиксированная строка games#eventRecordRequest .

requestId

string ( int64 format)

Идентификатор запроса, используемый для идентификации этой попытки записи событий.

currentTimeMillis

string ( int64 format)

Текущее время отправки этого обновления в миллисекундах с момента 1970 года по всемирному координированному времени (Unix Epoch).

timePeriods[]

object ( EventPeriodUpdate )

Список обновлений за период времени, сделанных в этом запросе.

СобытиеПериодОбновление

Ресурс обновления периода событий.

JSON-представление
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Поля
timePeriod

object ( EventPeriodRange )

Период времени, на который распространяется это обновление.

updates[]

object ( EventUpdateRequest )

Обновления, сделанные за этот период времени.

kind

string

Уникально определяет тип этого ресурса. Значением всегда является фиксированная строка games#eventPeriodUpdate .

Диапазон СобытийПериода

Временной диапазон периода события.

JSON-представление
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Поля
kind

string

Уникально определяет тип этого ресурса. Значением всегда является фиксированная строка games#eventPeriodRange .

periodStartMillis

string ( int64 format)

Время начала этого периода обновления в миллисах с 1970 года по всемирному координированному времени (Unix Epoch).

periodEndMillis

string ( int64 format)

Время окончания этого периода обновления в миллисах с 1970 года по всемирному координированному времени (эпоха Unix).

СобытиеОбновлениеЗапрос

Ресурс обновления периода событий.

JSON-представление
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
Поля
definitionId

string

Идентификатор события, изменяемого в этом обновлении.

updateCount

string ( int64 format)

Сколько раз это событие произошло за этот период времени.

kind

string

Уникально определяет тип этого ресурса. Значением всегда является фиксированная строка games#eventUpdateRequest .

СобытиеПакетнаяЗаписьОшибка

Ресурс сбоя пакетного обновления.

JSON-представление
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
Поля
range

object ( EventPeriodRange )

Диапазон времени, который был отклонен; пусто для сбоя всего запроса.

failureCause

enum ( EventFailureCause )

Причина сбоя обновления.

kind

string

Уникально определяет тип этого ресурса. Значением всегда является фиксированная строка games#eventBatchRecordFailure .

СобытиеОтказПричина

Возможные значения причины сбоя события.

Перечисления
TOO_LARGE Пакетный запрос был отправлен с большим количеством событий, чем разрешено в одном пакете.
TIME_PERIOD_EXPIRED Пакет был отправлен с данными, которые находились слишком далеко в прошлом, чтобы их можно было записать.
TIME_PERIOD_SHORT Пакет был отправлен со слишком коротким временным диапазоном.
TIME_PERIOD_LONG Пакет был отправлен со слишком большим временным диапазоном.
ALREADY_UPDATED Была предпринята попытка записать пакет данных, который уже был виден.
RECORD_RATE_HIGH Была предпринята попытка записать данные быстрее, чем сервер применит обновления.

СобытиеЗаписьОтказ

Ресурс сбоя обновления события.

JSON-представление
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
Поля
eventId

string

Идентификатор события, которое не было обновлено.

failureCause

enum ( EventUpdateFailureCause )

Причина сбоя обновления.

kind

string

Уникально определяет тип этого ресурса. Значением всегда является фиксированная строка games#eventRecordFailure .

СобытиеОбновлениеОтказПричина

Возможные значения причины сбоя обновления события.

Перечисления
NOT_FOUND Была предпринята попытка установить событие, которое не было определено.
INVALID_UPDATE_VALUE Была предпринята попытка увеличить событие на неположительное значение.