- Permintaan HTTP
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Cobalah!
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 |
Bahasa yang lebih disukai 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 ( |
Kolom | |
---|---|
kind |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap |
batchFailures[] |
Kegagalan tingkat batch apa pun yang terjadi saat menerapkan pembaruan. |
eventFailures[] |
Setiap kegagalan saat memperbarui peristiwa tertentu. |
playerEvents[] |
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 ( |
Kolom | |
---|---|
kind |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap |
requestId |
ID permintaan yang digunakan untuk mengidentifikasi upaya merekam peristiwa ini. |
currentTimeMillis |
Waktu saat ini saat update ini dikirim, dalam milidetik, sejak 1970 UTC (Unix Epoch). |
timePeriods[] |
Daftar pembaruan jangka waktu yang dibuat dalam permintaan ini. |
EventPeriodUpdate
Resource pembaruan periode peristiwa.
Representasi JSON |
---|
{ "timePeriod": { object ( |
Kolom | |
---|---|
timePeriod |
Jangka waktu yang dicakup oleh pembaruan ini. |
updates[] |
Pembaruan 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 saat periode update ini dimulai, dalam milidetik, sejak 1970 UTC (Unix Epoch). |
periodEndMillis |
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 |
ID peristiwa 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 di 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 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 ( |
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 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. |