Method: events.record

Merekam kumpulan perubahan frekuensi terjadinya peristiwa untuk pengguna aplikasi yang saat ini diautentikasi.

Permintaan HTTP

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

Parameter kueri

Parameter
language

string

Bahasa yang dipilih untuk digunakan untuk string yang ditampilkan oleh metode ini.

Isi permintaan

Isi permintaan memuat instance EventsUpdates.

Isi respons

Resource pembaruan periode acara.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

Semua kegagalan di seluruh batch yang terjadi saat menerapkan update.
eventFailures[]

object (EventRecordFailure)

Kegagalan saat memperbarui acara tertentu.
playerEvents[]

object (PlayerEvent)

Status saat ini dari setiap acara yang diperbarui

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

EventsUpdates

Resource pembaruan periode acara.

Representasi JSON 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#eventRecordRequest.
requestId

string (int64 format)

ID permintaan yang digunakan untuk mengidentifikasi upaya ini untuk mencatat peristiwa.
currentTimeMillis

string (int64 format)

Waktu saat pembaruan ini dikirim, dalam milidetik, sejak tahun 1970 UTC (Unix Epoch).
timePeriods[]

object (EventPeriodUpdate)

Daftar pembaruan jangka waktu yang dibuat dalam permintaan ini.

EventPeriodUpdate

Resource pembaruan periode acara.

Representasi JSON 
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Kolom
timePeriod

object (EventPeriodRange)

Jangka waktu yang dicakup oleh pembaruan ini.
updates[]

object (EventUpdateRequest)

Pembaruan yang dilakukan untuk jangka waktu ini.
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#eventPeriodUpdate.

EventPeriodRange

Rentang waktu periode peristiwa.

Representasi JSON 
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#eventPeriodRange.
periodStartMillis

string (int64 format)

Waktu periode update ini dimulai, dalam ribuan, sejak 1970 UTC (Unix Epoch).
periodEndMillis

string (int64 format)

Waktu saat periode update ini berakhir, dalam ribuan, sejak 1970 UTC (Unix Epoch).

EventUpdateRequest

Resource pembaruan periode acara.

Representasi JSON 
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
Kolom
definitionId

string

ID acara yang diubah dalam pembaruan ini.
updateCount

string (int64 format)

Berapa kali peristiwa ini terjadi dalam jangka waktu ini.
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#eventUpdateRequest.

EventBatchRecordFailure

Resource kegagalan update batch.

Representasi JSON 
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
Kolom
range

object (EventPeriodRange)

Rentang waktu yang ditolak; kosong untuk kegagalan seluruh permintaan.
failureCause

enum (EventFailureCause)

Penyebab kegagalan update.
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#eventBatchRecordFailure.

EventFailureCause

Nilai yang mungkin untuk penyebab kegagalan peristiwa.

Enum
TOO_LARGE Permintaan batch dikeluarkan dengan lebih banyak peristiwa dari yang diizinkan dalam satu batch.
TIME_PERIOD_EXPIRED Batch dikirim dengan data terlalu jauh di masa lalu untuk direkam.
TIME_PERIOD_SHORT Batch dikirim dengan rentang waktu yang terlalu pendek.
TIME_PERIOD_LONG Batch dikirim dengan rentang waktu yang terlalu panjang.
ALREADY_UPDATED Upaya dilakukan untuk merekam batch data yang sudah terlihat.
RECORD_RATE_HIGH Upaya telah dilakukan untuk merekam data lebih cepat daripada server akan menerapkan pembaruan.

EventRecordFailure

Resource kegagalan update acara.

Representasi JSON 
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
Kolom
eventId

string

ID acara yang tidak diperbarui.
failureCause

enum (EventUpdateFailureCause)

Penyebab kegagalan update.
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#eventRecordFailure.

EventUpdateFailureCause

Nilai yang mungkin menyebabkan kegagalan update peristiwa.

Enum
NOT_FOUND Upaya telah dilakukan untuk menetapkan peristiwa yang belum ditetapkan.
INVALID_UPDATE_VALUE Sebuah upaya telah dilakukan untuk menaikkan peristiwa dengan nilai non-positif.