- 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 エポック)からの、この更新が送信された現在の時刻(ミリ秒単位)。 |
timePeriods[] |
このリクエストで行われる期間の更新のリスト。 |
EventPeriodUpdate
イベント期間の更新リソース。
JSON 表現 |
---|
{ "timePeriod": { object ( |
フィールド | |
---|---|
timePeriod |
このアップデートの対象となる期間。 |
updates[] |
この期間に実施される更新です。 |
kind |
このリソースのタイプを一意に識別します。値は常に固定文字列 |
EventPeriodRange
イベント期間。
JSON 表現 |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
フィールド | |
---|---|
kind |
このリソースのタイプを一意に識別します。値は常に固定文字列 |
periodStartMillis |
1970 年 UTC(Unix エポック)からの、この更新期間の開始時刻(ミリ秒単位)。 |
periodEndMillis |
1970 年 UTC(Unix エポック)からの、この更新期間の終了時刻(ミリ秒単位)。 |
EventUpdateRequest
イベント期間の更新リソース。
JSON 表現 |
---|
{ "definitionId": string, "updateCount": string, "kind": string } |
フィールド | |
---|---|
definitionId |
この更新で変更されるイベントの ID。 |
updateCount |
この期間にこのイベントが発生した回数です。 |
kind |
このリソースのタイプを一意に識別します。値は常に固定文字列 |
EventBatchRecordFailure
バッチ アップデートの失敗リソース。
JSON 表現 |
---|
{ "range": { object ( |
フィールド | |
---|---|
range |
拒否された期間。リクエスト全体の障害の場合は空です。 |
failureCause |
更新に失敗した原因。 |
kind |
このリソースのタイプを一意に識別します。値は常に固定文字列 |
EventFailureCause
イベント失敗の原因の有効な値。
列挙型 | |
---|---|
TOO_LARGE |
1 つのバッチで許可されている数を超えるイベントを含むバッチ リクエストが発行されました。 |
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 |
イベントを正の値以外でインクリメントしようとしました。 |