Method: events.record

Zeichnet einen Stapel von Änderungen der Ereignisse auf, die für den aktuell authentifizierten Nutzer dieser Anwendung aufgetreten sind.

HTTP-Anfrage

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

Abfrageparameter

Parameter
language

string

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

Anfragetext

Der Anfragetext enthält eine Instanz von EventsUpdates.

Antworttext

Eine Update-Ressource für den Ereigniszeitraum.

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

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

object (EventBatchRecordFailure)

Alle Batch-weiten Fehler, die beim Anwenden von Aktualisierungen aufgetreten sind.
eventFailures[]

object (EventRecordFailure)

Alle Fehler beim Aktualisieren eines bestimmten Ereignisses.
playerEvents[]

object (PlayerEvent)

Aktueller Status aktualisierter 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 Update-Ressource für den Ereigniszeitraum.

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

string

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

string (int64 format)

Die Anfrage-ID, mit der dieser Versuch zum Aufzeichnen von Ereignissen identifiziert wird.
currentTimeMillis

string (int64 format)

Der aktuelle 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 Update-Ressource für den Ereigniszeitraum.

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

object (EventPeriodRange)

Der Zeitraum, für den das Update gilt.
updates[]

object (EventUpdateRequest)

Die für diesen Zeitraum vorgenommenen Aktualisierungen.
kind

string

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

EventPeriodRange

Ereigniszeitraum

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

string

Identifiziert eindeutig den Typ dieser Ressource. 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)

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

EventUpdateRequest

Eine Update-Ressource für den Ereigniszeitraum.

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

string

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

string (int64 format)

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

string

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

EventBatchRecordFailure

Eine Ressource für einen Batch-Updatefehler.

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

object (EventPeriodRange)

Der Zeitraum, der abgelehnt wurde. Das Feld ist leer, wenn die gesamte Anfrage fehlgeschlagen ist.
failureCause

enum (EventFailureCause)

Die Ursache des Updatefehlers.
kind

string

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

EventFailureCause

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

Enums
TOO_LARGE Eine Batchanfrage wurde mit mehr Ereignissen ausgegeben, als in einem einzelnen Batch zulässig sind.
TIME_PERIOD_EXPIRED Ein Batch wurde mit Daten gesendet, die zu weit in der Vergangenheit liegen, um aufgezeichnet zu werden.
TIME_PERIOD_SHORT Ein Batch wurde mit einem zu kurzen Zeitraum gesendet.
TIME_PERIOD_LONG Ein Batch wurde mit einem zu langen Zeitraum gesendet.
ALREADY_UPDATED Es wurde versucht, einen Daten-Batch aufzunehmen, der bereits erfasst wurde.
RECORD_RATE_HIGH Es wurde versucht, Daten schneller aufzuzeichnen, als der Server die Aktualisierungen durchführt.

EventRecordFailure

Eine Ressource für einen Fehler bei der Aktualisierung eines Ereignisses.

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 des Updatefehlers.
kind

string

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

EventUpdateFailureCause

Mögliche Werte für die Ursache eines Fehlers beim Aktualisieren eines Ereignisses.

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.