方法:events.record

记录此应用的当前身份验证用户事件发生次数的一批变更。

HTTP 请求

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

查询参数

参数
language

字符串

此方法返回的字符串的首选语言。

请求正文

请求正文包含以下实例:EventsUpdates

响应正文

一个事件时段更新资源。

如果成功,响应正文将包含具有以下结构的数据

JSON 表示法
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
字段
kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#eventUpdateResponse

batchFailures[]

对象 (EventBatchRecordFailure)

应用更新时发生的任何批次范围的故障。

eventFailures[]

对象 (EventRecordFailure)

更新特定事件时发生的任何故障。

playerEvents[]

对象 (PlayerEvent)

任何已更新事件的当前状态

授权范围

需要以下其中一个 OAuth 范围

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

如需了解详情,请参阅OAuth 2.0 概览

EventsUpdates

一个事件时段更新资源。

JSON 表示法
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
字段
kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#eventRecordRequest

requestId

字符串 (int64 格式)

用于标识此事件记录尝试的请求 ID。

currentTimeMillis

字符串 (int64 格式)

发送此更新时的当前时间,以毫秒为单位,自 1970 年 UTC (Unix Epoch) 起算。

timePeriods[]

对象 (EventPeriodUpdate)

此请求中进行的时间段更新列表。

EventPeriodUpdate

一个事件时段更新资源。

JSON 表示法
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
字段
timePeriod

对象 (EventPeriodRange)

此更新涵盖的时间段。

updates[]

对象 (EventUpdateRequest)

此时间段的更新。

kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#eventPeriodUpdate

EventPeriodRange

一个事件时段时间范围。

JSON 表示法
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
字段
kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#eventPeriodRange

periodStartMillis

字符串 (int64 格式)

此更新时段开始的时间,以毫秒为单位,自 1970 年 UTC (Unix Epoch) 起算。

periodEndMillis

字符串 (int64 格式)

此更新时段结束的时间,以毫秒为单位,自 1970 年 UTC (Unix Epoch) 起算。

EventUpdateRequest

一个事件时段更新资源。

JSON 表示法
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
字段
definitionId

字符串

在此更新中修改的事件的 ID。

updateCount

字符串 (int64 格式)

此事件在此时间段内发生的次数。

kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#eventUpdateRequest

EventBatchRecordFailure

一个批次更新失败资源。

JSON 表示法
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
字段
range

对象 (EventPeriodRange)

被拒绝的时间范围;对于请求范围的故障为空。

failureCause

枚举 (EventFailureCause)

更新失败的原因。

kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#eventBatchRecordFailure

EventFailureCause

事件失败原因的可能值。

枚举值
TOO_LARGE 发出的批次请求包含的事件数量超过了单个批次允许的数量。
TIME_PERIOD_EXPIRED 发送的批次数据时间过早,无法记录。
TIME_PERIOD_SHORT 发送的批次数据时间范围过短。
TIME_PERIOD_LONG 发送的批次数据时间范围过长。
ALREADY_UPDATED 尝试记录一批已见过的数据。
RECORD_RATE_HIGH 尝试以服务器应用更新的速度更快的速度记录数据。

EventRecordFailure

一个事件更新失败资源。

JSON 表示法
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
字段
eventId

字符串

未更新的事件的 ID。

failureCause

枚举 (EventUpdateFailureCause)

更新失败的原因。

kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#eventRecordFailure

EventUpdateFailureCause

事件更新失败原因的可能值。

枚举值
NOT_FOUND 尝试设置未定义的事件。
INVALID_UPDATE_VALUE 尝试以非正值增加事件。