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 概览。

EventsUpdates

事件周期更新资源。

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

string

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

string (int64 format)

用于标识这次尝试记录事件的请求 ID。
currentTimeMillis

string (int64 format)

发送此更新的当前时间（以毫秒为单位，自 1970 年 1 月 1 日世界协调时间 [UTC] [Unix 纪元] 起算）。
timePeriods[]

object (EventPeriodUpdate)

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

EventPeriodUpdate

事件周期更新资源。

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

object (EventPeriodRange)

此更新涵盖的时间段。
updates[]

object (EventUpdateRequest)

在此时间段内进行的更新。
kind

string

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

EventPeriodRange

事件周期时间范围。

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

string

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

string (int64 format)

此更新周期的开始时间（以毫秒为单位，从 1970 年 1 月 1 日世界协调时间 [Unix 纪元] 算起）。
periodEndMillis

string (int64 format)

此更新周期的结束时间（以毫秒为单位，自 1970 年 1 月 1 日世界协调时间 [Unix 纪元] 起算）。

EventUpdateRequest

事件周期更新资源。

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

string

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

string (int64 format)

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

string

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

EventBatchRecordFailure

批量更新失败资源。

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

object (EventPeriodRange)

遭拒的时间范围；如果请求全部失败，则为空。
failureCause

enum (EventFailureCause)

更新失败的原因。
kind

string

唯一标识此资源的类型。值始终为固定字符串 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

string

未更新的事件的 ID。
failureCause

enum (EventUpdateFailureCause)

更新失败的原因。
kind

string

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

EventUpdateFailureCause

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

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