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 尝试用非正值递增事件。