Method: events.record

Bu uygulamanın mevcut durumda kimliği doğrulanmış kullanıcısı için etkinliklerin kaç kez oluştuğunda yapılan değişiklikleri toplu olarak kaydeder.

HTTP isteği

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

Sorgu parametreleri

Parametreler
language

string

Bu yöntemin döndürdüğü dizeler için kullanılması tercih edilen dil.

İstek içeriği

İstek metni, EventsUpdates öğesinin bir örneğini içerir.

Yanıt gövdesi

Etkinlik dönemi güncelleme kaynağı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#eventUpdateResponse sabit dizesidir.
batchFailures[]

object (EventBatchRecordFailure)

Güncellemeler uygulanırken oluşan toplu ölçekte hatalar.
eventFailures[]

object (EventRecordFailure)

Belirli bir etkinliği güncellerken meydana gelen hatalar.
playerEvents[]

object (PlayerEvent)

Güncellenen etkinliklerin şu anki durumu

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

EventsUpdates

Etkinlik dönemi güncelleme kaynağı.

JSON gösterimi 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#eventRecordRequest sabit dizesidir.
requestId

string (int64 format)

Bu etkinlikleri kaydetme girişimini tanımlamak için kullanılan istek kimliği.
currentTimeMillis

string (int64 format)

1970 UTC'den (Unix Epoch) itibaren bu güncellemenin milisaniye cinsinden gönderildiği geçerli saat.
timePeriods[]

object (EventPeriodUpdate)

Bu istekte yapılan dönem güncellemelerinin listesi.

EventPeriodUpdate

Etkinlik dönemi güncelleme kaynağı.

JSON gösterimi 
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Alanlar
timePeriod

object (EventPeriodRange)

Bu güncellemenin kapsadığı dönem.
updates[]

object (EventUpdateRequest)

Bu dönem için yapılacak güncellemeler.
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#eventPeriodUpdate sabit dizesidir.

EventPeriodRange

Etkinlik dönemi zaman aralığı.

JSON gösterimi 
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#eventPeriodRange sabit dizesidir.
periodStartMillis

string (int64 format)

1970 UTC'den (Unix Epoch) itibaren bu güncelleme döneminin milisaniye cinsinden başladığı zaman.
periodEndMillis

string (int64 format)

1970 UTC'den (Unix Epoch) itibaren bu güncelleme döneminin sona erdiği zaman (milisaniye cinsinden).

EventUpdateRequest

Etkinlik dönemi güncelleme kaynağı.

JSON gösterimi 
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
Alanlar
definitionId

string

Bu güncellemede değiştirilen etkinliğin kimliği.
updateCount

string (int64 format)

Bu etkinliğin, bu dönem içinde gerçekleşme sayısı.
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#eventUpdateRequest sabit dizesidir.

EventBatchRecordFailure

Toplu güncelleme başarısız kaynağı.

JSON gösterimi 
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
Alanlar
range

object (EventPeriodRange)

Reddedilen zaman aralığı; istek genelindeki bir hata için boştur.
failureCause

enum (EventFailureCause)

Güncelleme hatasının nedeni.
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#eventBatchRecordFailure sabit dizesidir.

EventFailureCause

Etkinliğin başarısız olmasına yol açan olası değerler.

Sıralamalar
TOO_LARGE Bir toplu istek, tek bir grupta izin verilenden fazla etkinlikle gönderildi.
TIME_PERIOD_EXPIRED Kaydedilemeyecek kadar geçmişteki verilere sahip bir grup gönderildi.
TIME_PERIOD_SHORT Çok kısa bir zaman aralığına sahip bir grup gönderildi.
TIME_PERIOD_LONG Zaman aralığı çok uzun olan bir grup gönderildi.
ALREADY_UPDATED Daha önce görülen bir veri grubu kaydedilmeye çalışıldı.
RECORD_RATE_HIGH Verilerin, sunucunun güncellemeleri uygulayacağından daha hızlı kaydedilmesine çalışıldı.

EventRecordFailure

Etkinlik güncelleme başarısız kaynağı.

JSON gösterimi 
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
Alanlar
eventId

string

Güncellenmeyen etkinliğin kimliği.
failureCause

enum (EventUpdateFailureCause)

Güncelleme hatasının nedeni.
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#eventRecordFailure sabit dizesidir.

EventUpdateFailureCause

Etkinlik güncelleme hatasının nedenine ilişkin olası değerler.

Sıralamalar
NOT_FOUND Tanımlanmamış bir etkinlik oluşturulmaya çalışıldı.
INVALID_UPDATE_VALUE Bir etkinliğin değerini pozitif olmayan bir değerle artırma girişiminde bulunuldu.