- HTTP 请求
- 查询参数
- 请求正文
- 响应正文
- 授权范围
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- 试试看!
记录此应用的当前身份验证用户事件发生次数的一批变更。
HTTP 请求
POST https://games.googleapis.com/games/v1/events
查询参数
参数 | |
---|---|
language |
此方法返回的字符串的首选语言。 |
请求正文
请求正文包含以下实例:EventsUpdates
。
响应正文
一个事件时段更新资源。
如果成功,响应正文将包含具有以下结构的数据
JSON 表示法 |
---|
{ "kind": string, "batchFailures": [ { object ( |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
batchFailures[] |
应用更新时发生的任何批次范围的故障。 |
eventFailures[] |
更新特定事件时发生的任何故障。 |
playerEvents[] |
任何已更新事件的当前状态 |
授权范围
需要以下其中一个 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 ( |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
requestId |
用于标识此事件记录尝试的请求 ID。 |
currentTimeMillis |
发送此更新时的当前时间,以毫秒为单位,自 1970 年 UTC (Unix Epoch) 起算。 |
timePeriods[] |
此请求中进行的时间段更新列表。 |
EventPeriodUpdate
一个事件时段更新资源。
JSON 表示法 |
---|
{ "timePeriod": { object ( |
字段 | |
---|---|
timePeriod |
此更新涵盖的时间段。 |
updates[] |
此时间段的更新。 |
kind |
唯一标识此资源的类型。值始终是固定字符串 |
EventPeriodRange
一个事件时段时间范围。
JSON 表示法 |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
字段 | |
---|---|
kind |
唯一标识此资源的类型。值始终是固定字符串 |
periodStartMillis |
此更新时段开始的时间,以毫秒为单位,自 1970 年 UTC (Unix Epoch) 起算。 |
periodEndMillis |
此更新时段结束的时间,以毫秒为单位,自 1970 年 UTC (Unix Epoch) 起算。 |
EventUpdateRequest
一个事件时段更新资源。
JSON 表示法 |
---|
{ "definitionId": string, "updateCount": string, "kind": string } |
字段 | |
---|---|
definitionId |
在此更新中修改的事件的 ID。 |
updateCount |
此事件在此时间段内发生的次数。 |
kind |
唯一标识此资源的类型。值始终是固定字符串 |
EventBatchRecordFailure
一个批次更新失败资源。
JSON 表示法 |
---|
{ "range": { object ( |
字段 | |
---|---|
range |
被拒绝的时间范围;对于请求范围的故障为空。 |
failureCause |
更新失败的原因。 |
kind |
唯一标识此资源的类型。值始终是固定字符串 |
EventFailureCause
事件失败原因的可能值。
枚举值 | |
---|---|
TOO_LARGE |
发出的批次请求包含的事件数量超过了单个批次允许的数量。 |
TIME_PERIOD_EXPIRED |
发送的批次数据时间过早,无法记录。 |
TIME_PERIOD_SHORT |
发送的批次数据时间范围过短。 |
TIME_PERIOD_LONG |
发送的批次数据时间范围过长。 |
ALREADY_UPDATED |
尝试记录一批已见过的数据。 |
RECORD_RATE_HIGH |
尝试以服务器应用更新的速度更快的速度记录数据。 |
EventRecordFailure
一个事件更新失败资源。
JSON 表示法 |
---|
{
"eventId": string,
"failureCause": enum ( |
字段 | |
---|---|
eventId |
未更新的事件的 ID。 |
failureCause |
更新失败的原因。 |
kind |
唯一标识此资源的类型。值始终是固定字符串 |
EventUpdateFailureCause
事件更新失败原因的可能值。
枚举值 | |
---|---|
NOT_FOUND |
尝试设置未定义的事件。 |
INVALID_UPDATE_VALUE |
尝试以非正值增加事件。 |