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 1 つのバッチで許可されている数を超えるイベントでバッチ リクエストが発行されました。
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 イベントを正の値でインクリメントしようとしました。