Method: events.record

Bu uygulamanın kimliği doğrulanmış o anki kullanıcısı için etkinliklerin gerçekleşme sayısında 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 sabit games#eventUpdateResponse dizesidir.
batchFailures[]

object (EventBatchRecordFailure)

Güncellemeler uygulanırken oluşan grup genelindeki hatalar.
eventFailures[]

object (EventRecordFailure)

Belirli bir etkinliğin güncellenmesi başarısız oldu.
playerEvents[]

object (PlayerEvent)

Güncellenen etkinliklerin mevcut 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atı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 sabit games#eventRecordRequest dizesidir.
requestId

string (int64 format)

Bu etkinlik 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 zaman.
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ılan güncellemeler.
kind

string

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

EventPeriodRange

Etkinlik dönemi zaman aralığıdır.

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 sabit games#eventPeriodRange dizesidir.
periodStartMillis

string (int64 format)

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

string (int64 format)

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

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 sabit games#eventUpdateRequest dizesidir.

EventBatchRecordFailure

Toplu güncelleme hatası kaynağı.

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

object (EventPeriodRange)

Reddedilen zaman aralığı boş bırakın.
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 sabit games#eventBatchRecordFailure dizesidir.

EventFailureCause

Etkinlik hatası nedeni için olası değerler.

Sıralamalar
TOO_LARGE Tek bir grupta izin verilenden daha fazla etkinlik içeren bir toplu istek gönderildi.
TIME_PERIOD_EXPIRED Kaydedilemeyecek kadar eski verilere sahip bir grup gönderildi.
TIME_PERIOD_SHORT Çok kısa bir zaman aralığıyla 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 grubunun kaydedilmesine çalışıldı.
RECORD_RATE_HIGH Verilerin, sunucunun güncellemeleri uygulayacağından daha hızlı şekilde kaydedilmeye çalışıldı.

EventRecordFailure

Etkinlik güncelleme hatası 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 sabit games#eventRecordFailure dizesidir.

EventUpdateFailureCause

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

Sıralamalar
NOT_FOUND Tanımlanmamış bir etkinlik ayarlamak için girişimde bulunuldu.
INVALID_UPDATE_VALUE Bir etkinliği pozitif olmayan bir değer oranında artırma girişiminde bulunuldu.