Method: events.record

Zeichnet einen Batch von Änderungen auf, wie oft für den derzeit authentifizierten Nutzer dieser Anwendung Ereignisse aufgetreten sind.

HTTP-Anfrage

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

Abfrageparameter

Parameter
language

string

Die bevorzugte Sprache für Strings, die von dieser Methode zurückgegeben werden.

Anfragetext

Der Anfragetext enthält eine Instanz von EventsUpdates.

Antworttext

Eine Ressource zum Aktualisieren des Ereigniszeitraums.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Felder
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

Alle Batch-Fehler bei der Anwendung von Updates.
eventFailures[]

object (EventRecordFailure)

Alle Fehler beim Aktualisieren eines bestimmten Ereignisses.
playerEvents[]

object (PlayerEvent)

Der aktuelle Status aller aktualisierten Ereignisse

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

EventsUpdates

Eine Ressource zum Aktualisieren des Ereigniszeitraums.

JSON-Darstellung 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
Felder
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#eventRecordRequest.
requestId

string (int64 format)

Die Anfrage-ID, mit der dieser Versuch zur Ereignisaufzeichnung identifiziert wird.
currentTimeMillis

string (int64 format)

Zeitpunkt, zu dem dieses Update gesendet wurde, in Millisekunden seit 1970 UTC (Unixzeit).
timePeriods[]

object (EventPeriodUpdate)

Eine Liste der Zeitraumaktualisierungen, die in dieser Anfrage vorgenommen werden.

EventPeriodUpdate

Eine Ressource zum Aktualisieren des Ereigniszeitraums.

JSON-Darstellung 
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Felder
timePeriod

object (EventPeriodRange)

Der Zeitraum, auf den sich dieses Update bezieht.
updates[]

object (EventUpdateRequest)

Die Aktualisierungen, die für diesen Zeitraum vorgenommen werden.
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#eventPeriodUpdate.

EventPeriodRange

Zeitraum für einen Ereigniszeitraum.

JSON-Darstellung 
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Felder
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#eventPeriodRange.
periodStartMillis

string (int64 format)

Der Zeitpunkt, an dem dieser Aktualisierungszeitraum beginnt, in Millisekunden seit 1970 UTC (Unixzeit).
periodEndMillis

string (int64 format)

Der Zeitpunkt, an dem dieser Aktualisierungszeitraum endet, in Millisekunden seit 1970 UTC (Unixzeit).

EventUpdateRequest

Eine Ressource zum Aktualisieren des Ereigniszeitraums.

JSON-Darstellung 
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
Felder
definitionId

string

Die ID des Ereignisses, das bei diesem Update geändert wird.
updateCount

string (int64 format)

Gibt an, wie oft dieses Ereignis in diesem Zeitraum aufgetreten ist.
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#eventUpdateRequest.

EventBatchRecordFailure

Eine Ressource für Batch-Update-Fehler.

JSON-Darstellung 
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
Felder
range

object (EventPeriodRange)

Zeitraum, der abgelehnt wurde für einen anfrageweiten Fehler leer.
failureCause

enum (EventFailureCause)

Die Ursache für das fehlgeschlagene Update.
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#eventBatchRecordFailure.

EventFailureCause

Mögliche Werte für die Ursache eines Ereignisfehlers.

Enums
TOO_LARGE Es wurde eine Batchanfrage mit mehr Ereignissen gesendet, als in einem Batch zulässig sind.
TIME_PERIOD_EXPIRED Ein Batch mit Daten wurde gesendet, die zu weit in der Vergangenheit liegen, um aufgezeichnet zu werden.
TIME_PERIOD_SHORT Ein Batch wurde über einen zu kurzen Zeitraum gesendet.
TIME_PERIOD_LONG Ein Batch wurde mit einem zu langen Zeitraum gesendet.
ALREADY_UPDATED Es wurde versucht, einen Batch von Daten aufzuzeichnen, die bereits erkannt wurden.
RECORD_RATE_HIGH Es wurde versucht, Daten schneller aufzuzeichnen, als der Server Aktualisierungen anwendet.

EventRecordFailure

Eine Ressource für Fehler bei der Aktualisierung von Ereignissen.

JSON-Darstellung 
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
Felder
eventId

string

Die ID des Ereignisses, das nicht aktualisiert wurde.
failureCause

enum (EventUpdateFailureCause)

Die Ursache für das fehlgeschlagene Update.
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#eventRecordFailure.

EventUpdateFailureCause

Mögliche Werte für die Ursache eines Fehlers bei der Ereignisaktualisierung.

Enums
NOT_FOUND Es wurde versucht, ein nicht definiertes Ereignis festzulegen.
INVALID_UPDATE_VALUE Es wurde versucht, ein Ereignis um einen nicht positiven Wert zu erhöhen.