Method: events.record

Ghi lại một loạt các thay đổi về số lần sự kiện đã xảy ra đối với người dùng hiện đã được xác thực của ứng dụng này.

Yêu cầu HTTP

POST https://games.googleapis.com/games/v1/events

Tham số truy vấn

Các tham số
language

string

Ngôn ngữ ưu tiên dùng cho các chuỗi được phương thức này trả về.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của EventsUpdates.

Nội dung phản hồi

Tài nguyên cập nhật khoảng thời gian sự kiện.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

Mọi lỗi trên toàn lô xảy ra khi áp dụng bản cập nhật.
eventFailures[]

object (EventRecordFailure)

Mọi lỗi khi cập nhật một sự kiện cụ thể.
playerEvents[]

object (PlayerEvent)

Trạng thái hiện tại của mọi sự kiện đã cập nhật

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

EventsUpdates

Tài nguyên cập nhật khoảng thời gian sự kiện.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#eventRecordRequest.
requestId

string (int64 format)

Mã yêu cầu dùng để xác định lượt ghi lại sự kiện này.
currentTimeMillis

string (int64 format)

Thời gian hiện tại khi bản cập nhật này được gửi, tính bằng mili giây, kể từ năm 1970 theo giờ UTC (Unix Epoch).
timePeriods[]

object (EventPeriodUpdate)

Danh sách thông tin cập nhật về khoảng thời gian trong yêu cầu này.

EventPeriodUpdate

Tài nguyên cập nhật khoảng thời gian sự kiện.

Biểu diễn dưới dạng JSON 
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Các trường
timePeriod

object (EventPeriodRange)

Khoảng thời gian áp dụng cho bản cập nhật này.
updates[]

object (EventUpdateRequest)

Các nội dung cập nhật sẽ được thực hiện trong khoảng thời gian này.
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#eventPeriodUpdate.

EventPeriodRange

Phạm vi thời gian của một khoảng thời gian diễn ra sự kiện.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#eventPeriodRange.
periodStartMillis

string (int64 format)

Thời gian mà khoảng thời gian cập nhật này bắt đầu, tính bằng mili giây, kể từ năm 1970 giờ UTC (Unix Epoch).
periodEndMillis

string (int64 format)

Thời gian mà khoảng thời gian cập nhật này kết thúc (tính bằng mili giây) kể từ năm 1970 theo giờ UTC (Unix Epoch).

EventUpdateRequest

Tài nguyên cập nhật khoảng thời gian sự kiện.

Biểu diễn dưới dạng JSON 
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
Các trường
definitionId

string

Mã của sự kiện đang được sửa đổi trong bản cập nhật này.
updateCount

string (int64 format)

Số lần sự kiện này xảy ra trong khoảng thời gian này.
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#eventUpdateRequest.

EventBatchRecordFailure

Tài nguyên lỗi cập nhật hàng loạt.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
Các trường
range

object (EventPeriodRange)

Phạm vi thời gian bị từ chối; trống đối với lỗi trên toàn yêu cầu.
failureCause

enum (EventFailureCause)

Nguyên nhân cập nhật không thành công.
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#eventBatchRecordFailure.

EventFailureCause

Các giá trị có thể xảy ra đối với nguyên nhân lỗi sự kiện.

Enum
TOO_LARGE Một yêu cầu theo lô đã được đưa ra với số sự kiện nhiều hơn số sự kiện được cho phép trong một lô.
TIME_PERIOD_EXPIRED Một lô đã được gửi với dữ liệu quá xa trong quá khứ nên không thể ghi lại.
TIME_PERIOD_SHORT Một lô đã được gửi có phạm vi thời gian quá ngắn.
TIME_PERIOD_LONG Một lô đã được gửi có phạm vi thời gian quá dài.
ALREADY_UPDATED Chúng tôi đã cố gắng ghi lại một loạt dữ liệu đã được nhìn thấy.
RECORD_RATE_HIGH Chúng tôi đã cố gắng ghi lại dữ liệu nhanh hơn mức máy chủ áp dụng bản cập nhật.

EventRecordFailure

Tài nguyên lỗi cập nhật sự kiện.

Biểu diễn dưới dạng JSON 
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
Các trường
eventId

string

Mã của sự kiện chưa được cập nhật.
failureCause

enum (EventUpdateFailureCause)

Nguyên nhân cập nhật không thành công.
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#eventRecordFailure.

EventUpdateFailureCause

Các giá trị có thể có cho nguyên nhân cập nhật sự kiện không thành công.

Enum
NOT_FOUND Đã cố gắng đặt một sự kiện không được xác định.
INVALID_UPDATE_VALUE Người dùng đã cố gắng tăng số sự kiện theo một giá trị không dương.