- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Testen!
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 |
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 ( |
Felder | |
---|---|
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
batchFailures[] |
Alle Batch-weiten Fehler, die beim Anwenden von Aktualisierungen aufgetreten sind. |
eventFailures[] |
Alle Fehler beim Aktualisieren eines bestimmten Ereignisses. |
playerEvents[] |
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 ( |
Felder | |
---|---|
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
requestId |
Die Anfrage-ID, mit der dieser Versuch zum Aufzeichnen von Ereignissen identifiziert wird. |
currentTimeMillis |
Der aktuelle 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 Update-Ressource für den Ereigniszeitraum.
JSON-Darstellung |
---|
{ "timePeriod": { object ( |
Felder | |
---|---|
timePeriod |
Der Zeitraum, für den das Update gilt. |
updates[] |
Die für diesen Zeitraum vorgenommenen Aktualisierungen. |
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
EventPeriodRange
Ereigniszeitraum
JSON-Darstellung |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Felder | |
---|---|
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
periodStartMillis |
Der Zeitpunkt, an dem dieser Aktualisierungszeitraum beginnt, in Millisekunden seit 1970 UTC (Unixzeit). |
periodEndMillis |
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 |
Die ID des Ereignisses, das in diesem Update geändert wird. |
updateCount |
Gibt an, wie oft dieses Ereignis in diesem Zeitraum aufgetreten ist. |
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
EventBatchRecordFailure
Eine Ressource für einen Batch-Updatefehler.
JSON-Darstellung |
---|
{ "range": { object ( |
Felder | |
---|---|
range |
Der Zeitraum, der abgelehnt wurde. Das Feld ist leer, wenn die gesamte Anfrage fehlgeschlagen ist. |
failureCause |
Die Ursache des Updatefehlers. |
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
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 ( |
Felder | |
---|---|
eventId |
Die ID des Ereignisses, das nicht aktualisiert wurde. |
failureCause |
Die Ursache des Updatefehlers. |
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
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. |