Method: events.record

Merekam sekumpulan perubahan jumlah berapa kali peristiwa terjadi untuk pengguna yang saat ini diautentikasi oleh aplikasi ini.

Permintaan HTTP

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

Parameter kueri

Parameter
language

string

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

Isi permintaan

Isi permintaan memuat instance EventsUpdates.

Isi respons

Resource pembaruan periode peristiwa.

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)

Kegagalan tingkat batch apa pun yang terjadi saat menerapkan pembaruan.

eventFailures[]

object (EventRecordFailure)

Setiap kegagalan saat memperbarui peristiwa tertentu.

playerEvents[]

object (PlayerEvent)

Status terkini 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 peristiwa.

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 merekam peristiwa ini.

currentTimeMillis

string (int64 format)

Waktu saat ini saat update ini dikirim, dalam milidetik, sejak 1970 UTC (Unix Epoch).

timePeriods[]

object (EventPeriodUpdate)

Daftar pembaruan jangka waktu yang dibuat dalam permintaan ini.

EventPeriodUpdate

Resource pembaruan periode peristiwa.

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 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 saat periode update ini dimulai, dalam milidetik, sejak 1970 UTC (Unix Epoch).

periodEndMillis

string (int64 format)

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

EventUpdateRequest

Resource pembaruan periode peristiwa.

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

string

ID peristiwa 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 di 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 jumlah peristiwa yang lebih banyak dari yang diizinkan dalam satu batch.
TIME_PERIOD_EXPIRED Batch dikirim dengan data yang sudah terlalu jauh untuk direkam.
TIME_PERIOD_SHORT Batch dikirim dengan rentang waktu yang terlalu singkat.
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 dilakukan untuk merekam data lebih cepat daripada server menerapkan pembaruan.

EventRecordFailure

Resource kegagalan update peristiwa.

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 untuk penyebab kegagalan update peristiwa.

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