- 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 年世界標準時間 (Unix Epoch) 開始。 |
timePeriods[] |
要求中更新的時間範圍清單。 |
EventPeriodUpdate
事件期間更新資源。
JSON 表示法 |
---|
{ "timePeriod": { object ( |
欄位 | |
---|---|
timePeriod |
這項更新涵蓋的時間範圍。 |
updates[] |
這段時間內會進行更新。 |
kind |
專門識別這個資源的類型。值一律為固定字串 |
EventPeriodRange
事件的時間範圍。
JSON 表示法 |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
欄位 | |
---|---|
kind |
專門識別這個資源的類型。值一律為固定字串 |
periodStartMillis |
這個更新週期的開始時間,以毫秒為單位,自 1970 年世界標準時間 (Unix Epoch) 開始計算。 |
periodEndMillis |
這個更新週期的結束時間,以毫秒為單位,自 1970 年世界標準時間 (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 |
試圖以非正值增加事件數。 |