- Permintaan HTTP
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Cobalah!
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 |
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 ( |
Kolom | |
---|---|
kind |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap |
batchFailures[] |
Semua kegagalan di seluruh batch yang terjadi saat menerapkan update. |
eventFailures[] |
Kegagalan saat memperbarui acara tertentu. |
playerEvents[] |
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 ( |
Kolom | |
---|---|
kind |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap |
requestId |
ID permintaan yang digunakan untuk mengidentifikasi upaya ini untuk mencatat peristiwa. |
currentTimeMillis |
Waktu saat pembaruan ini dikirim, dalam milidetik, sejak tahun 1970 UTC (Unix Epoch). |
timePeriods[] |
Daftar pembaruan jangka waktu yang dibuat dalam permintaan ini. |
EventPeriodUpdate
Resource pembaruan periode acara.
Representasi JSON |
---|
{ "timePeriod": { object ( |
Kolom | |
---|---|
timePeriod |
Jangka waktu yang dicakup oleh pembaruan ini. |
updates[] |
Pembaruan yang dilakukan untuk jangka waktu ini. |
kind |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap |
EventPeriodRange
Rentang waktu periode peristiwa.
Representasi JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Kolom | |
---|---|
kind |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap |
periodStartMillis |
Waktu periode update ini dimulai, dalam ribuan, sejak 1970 UTC (Unix Epoch). |
periodEndMillis |
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 |
ID acara yang diubah dalam pembaruan ini. |
updateCount |
Berapa kali peristiwa ini terjadi dalam jangka waktu ini. |
kind |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap |
EventBatchRecordFailure
Resource kegagalan update batch.
Representasi JSON |
---|
{ "range": { object ( |
Kolom | |
---|---|
range |
Rentang waktu yang ditolak; kosong untuk kegagalan seluruh permintaan. |
failureCause |
Penyebab kegagalan update. |
kind |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap |
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 ( |
Kolom | |
---|---|
eventId |
ID acara yang tidak diperbarui. |
failureCause |
Penyebab kegagalan update. |
kind |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap |
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. |