- Yêu cầu HTTP
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Hãy làm thử!
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 |
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 ( |
Các trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
batchFailures[] |
Mọi lỗi trên toàn lô xảy ra khi áp dụng bản cập nhật. |
eventFailures[] |
Mọi lỗi khi cập nhật một sự kiện cụ thể. |
playerEvents[] |
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 ( |
Các trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
requestId |
Mã yêu cầu dùng để xác định lượt ghi lại sự kiện này. |
currentTimeMillis |
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[] |
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 ( |
Các trường | |
---|---|
timePeriod |
Khoảng thời gian áp dụng cho bản cập nhật này. |
updates[] |
Các nội dung cập nhật sẽ được thực hiện trong khoảng thời gian này. |
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
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 |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
periodStartMillis |
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 |
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 |
Mã của sự kiện đang được sửa đổi trong bản cập nhật này. |
updateCount |
Số lần sự kiện này xảy ra trong khoảng thời gian này. |
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
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 ( |
Các trường | |
---|---|
range |
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 |
Nguyên nhân cập nhật không thành công. |
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
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 ( |
Các trường | |
---|---|
eventId |
Mã của sự kiện chưa được cập nhật. |
failureCause |
Nguyên nhân cập nhật không thành công. |
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
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. |