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 年 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 年世界协调时间 (UTC)（Unix 公元纪年）开始。
periodEndMillis

string (int64 format)

自 1970 年 UTC（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 尝试按非正值递增事件。