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

Tham số
language

string

Ngôn ngữ ưu tiên sử 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 diễn ra 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)
    }
  ]
}
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 games#eventUpdateResponse cố định.
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 bài viết Tổng quan về OAuth 2.0.

EventsUpdates

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

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
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 games#eventRecordRequest cố định.
requestId

string (int64 format)

Mã yêu cầu dùng để xác định lần 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 (Kỷ nguyên Unix).
timePeriods[]

object (EventPeriodUpdate)

Danh sách khoảng thời gian cập nhật được thực hiện trong yêu cầu này.

EventPeriodUpdate

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

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

object (EventPeriodRange)

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

object (EventUpdateRequest)

Các nội dung cập nhật đang đượ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 games#eventPeriodUpdate cố định.

EventPeriodRange

Phạm vi thời gian của 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
}
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 games#eventPeriodRange cố định.
periodStartMillis

string (int64 format)

Thời điểm giai đoạn cập nhật này bắt đầu, tính bằng mili giây, kể từ năm 1970 theo giờ UTC (Kỷ nguyên Unix).
periodEndMillis

string (int64 format)

Thời gian khi 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 (Kỷ nguyên Unix).

EventUpdateRequest

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

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

string

Mã của sự kiện đang được sửa đổi trong lầ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 games#eventUpdateRequest cố định.

EventBatchRecordFailure

Tài nguyên lỗi cập nhật theo lô.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
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 không cập nhật được.
kind

string

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

EventFailureCause

Các giá trị có thể có cho nguyên nhân gây ra lỗi sự kiện.

Enum
TOO_LARGE Một yêu cầu hàng loạt đã được đưa ra với nhiều sự kiện hơn số sự kiện được 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 với phạm vi thời gian quá ngắn.
TIME_PERIOD_LONG Một lô đã được gửi với phạm vi thời gian quá dài.
ALREADY_UPDATED Chúng tôi đã cố gắng ghi lại một lô dữ liệu đã được nhìn thấy.
RECORD_RATE_HIGH Đã cố gắng ghi dữ liệu nhanh hơn so với việc máy chủ áp dụng các 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
}
Trường
eventId

string

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

enum (EventUpdateFailureCause)

Nguyên nhân không cập nhật được.
kind

string

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

EventUpdateFailureCause

Các giá trị có thể là nguyên nhân gây ra lỗi cập nhật sự kiện.

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