- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Testen!
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 |
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 ( |
Felder | |
---|---|
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
batchFailures[] |
Alle Batch-Fehler bei der Anwendung von Updates. |
eventFailures[] |
Alle Fehler beim Aktualisieren eines bestimmten Ereignisses. |
playerEvents[] |
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 ( |
Felder | |
---|---|
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
requestId |
Die Anfrage-ID, mit der dieser Versuch zur Ereignisaufzeichnung identifiziert wird. |
currentTimeMillis |
Zeitpunkt, zu dem dieses Update gesendet wurde, in Millisekunden seit 1970 UTC (Unixzeit). |
timePeriods[] |
Eine Liste der Zeitraumaktualisierungen, die in dieser Anfrage vorgenommen werden. |
EventPeriodUpdate
Eine Ressource zum Aktualisieren des Ereigniszeitraums.
JSON-Darstellung |
---|
{ "timePeriod": { object ( |
Felder | |
---|---|
timePeriod |
Der Zeitraum, auf den sich dieses Update bezieht. |
updates[] |
Die Aktualisierungen, die für diesen Zeitraum vorgenommen werden. |
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
EventPeriodRange
Ein Ereigniszeitraum.
JSON-Darstellung |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Felder | |
---|---|
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
periodStartMillis |
Der Zeitpunkt, an dem dieser Aktualisierungszeitraum beginnt, in Millisekunden seit 1970 UTC (Unixzeit). |
periodEndMillis |
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 |
Die ID des Ereignisses, das bei diesem Update geändert wird. |
updateCount |
Gibt an, wie oft dieses Ereignis in diesem Zeitraum aufgetreten ist. |
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
EventBatchRecordFailure
Eine Ressource für Batch-Update-Fehler.
JSON-Darstellung |
---|
{ "range": { object ( |
Felder | |
---|---|
range |
Zeitraum, der abgelehnt wurde für einen anfrageweiten Fehler leer. |
failureCause |
Die Ursache für das fehlgeschlagene Update. |
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
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 ( |
Felder | |
---|---|
eventId |
Die ID des Ereignisses, das nicht aktualisiert wurde. |
failureCause |
Die Ursache für das fehlgeschlagene Update. |
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
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. |