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 年世界標準時間 (Unix Epoch) 開始。
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 年世界標準時間 (Unix Epoch) 開始計算。
periodEndMillis

string (int64 format)

這個更新週期的結束時間，以毫秒為單位，自 1970 年世界標準時間 (Unix Epoch) 開始。

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 試圖以非正值增加事件數。