方法：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 纪元）起。
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 纪元）起。
periodEndMillis

字符串 (int64 格式)

此更新周期结束的时间（以毫秒为单位），自 1970 年 UTC（Unix 纪元）起。

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
}
字段
范围

对象 (EventPeriodRange)

被拒绝的时间范围；对于请求范围内的失败，该范围为空。
失败原因

枚举 (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。
失败原因

枚举 (EventUpdateFailureCause)

更新失败的原因。
kind

字符串

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

EventUpdateFailureCause

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

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