Method: events.record

Mencatat sekumpulan perubahan pada frekuensi terjadinya peristiwa untuk pengguna aplikasi ini yang saat ini diautentikasi.

Permintaan HTTP

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

Parameter kueri

Parameter
language

string

Bahasa yang lebih disukai untuk digunakan untuk string yang ditampilkan oleh metode ini.

Isi permintaan

Isi permintaan berisi instance EventsUpdates.

Isi respons

Resource pembaruan periode peristiwa.

Jika berhasil, isi respons berisi 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. Nilainya selalu berupa string tetap games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

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

object (EventRecordFailure)

Kegagalan apa pun saat memperbarui peristiwa tertentu.
playerEvents[]

object (PlayerEvent)

Status saat ini dari peristiwa 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 peristiwa.

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

string

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

string (int64 format)

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

string (int64 format)

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

object (EventPeriodUpdate)

Daftar pembaruan jangka waktu yang dilakukan dalam permintaan ini.

EventPeriodUpdate

Resource pembaruan periode peristiwa.

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

object (EventPeriodRange)

Periode waktu yang dicakup oleh update ini.
updates[]

object (EventUpdateRequest)

Pembaruan yang dilakukan untuk jangka waktu ini.
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilainya 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. Nilainya selalu berupa string tetap games#eventPeriodRange.
periodStartMillis

string (int64 format)

Waktu saat periode pembaruan ini dimulai, dalam milidetik, sejak 1970 UTC (Unix Epoch).
periodEndMillis

string (int64 format)

Waktu berakhirnya periode pembaruan ini, dalam milidetik, sejak 1970 UTC (Epoch Unix).

EventUpdateRequest

Resource pembaruan periode peristiwa.

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

string

ID peristiwa yang diubah dalam update ini.
updateCount

string (int64 format)

Frekuensi peristiwa ini terjadi dalam jangka waktu ini.
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilainya 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. Nilainya selalu berupa string tetap games#eventBatchRecordFailure.

EventFailureCause

Kemungkinan nilai untuk penyebab kegagalan peristiwa.

Enum
TOO_LARGE Permintaan batch dikeluarkan dengan lebih banyak peristiwa daripada yang diizinkan dalam satu batch.
TIME_PERIOD_EXPIRED Batch dikirim dengan data yang terlalu lama untuk dicatat.
TIME_PERIOD_SHORT Batch dikirim dengan rentang waktu yang terlalu singkat.
TIME_PERIOD_LONG Batch dikirim dengan rentang waktu yang terlalu lama.
ALREADY_UPDATED Upaya dilakukan untuk merekam batch data yang sudah dilihat.
RECORD_RATE_HIGH Upaya dilakukan untuk merekam data lebih cepat daripada server akan menerapkan update.

EventRecordFailure

Resource kegagalan pembaruan peristiwa.

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

string

ID peristiwa yang tidak diperbarui.
failureCause

enum (EventUpdateFailureCause)

Penyebab kegagalan update.
kind

string

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

EventUpdateFailureCause

Nilai yang mungkin untuk penyebab kegagalan pembaruan peristiwa.

Enum
NOT_FOUND Upaya dilakukan untuk menetapkan peristiwa yang tidak ditentukan.
INVALID_UPDATE_VALUE Upaya dilakukan untuk menambahkan peristiwa dengan nilai non-positif.