Method: events.record

Zapisuje grupę zmian liczby wystąpień zdarzeń w przypadku obecnie uwierzytelnionego użytkownika tej aplikacji.

Żądanie HTTP

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

Parametry zapytania

Parametry
language

string

Preferowany język używany w przypadku ciągów tekstowych zwracanych przez tę metodę.

Treść żądania

Treść żądania zawiera wystąpienie elementu EventsUpdates.

Treść odpowiedzi

Zasób do aktualizowania okresu wydarzenia.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

Wszystkie błędy wsadowe, które wystąpiły podczas stosowania aktualizacji.
eventFailures[]

object (EventRecordFailure)

nieudane aktualizacje konkretnego wydarzenia;
playerEvents[]

object (PlayerEvent)

Bieżący stan wszystkich zaktualizowanych zdarzeń.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

EventsUpdates

Zasób do aktualizowania okresu wydarzenia.

Zapis JSON 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#eventRecordRequest.
requestId

string (int64 format)

Identyfikator żądania służący do identyfikacji tej próby nagrania zdarzeń.
currentTimeMillis

string (int64 format)

Bieżący czas wysłania tej aktualizacji (w milisekundach), od 1970 roku UTC (epoka uniksowa).
timePeriods[]

object (EventPeriodUpdate)

Lista okresów i okresów, w których wprowadzana jest ta prośba.

EventPeriodUpdate

Zasób do aktualizowania okresu wydarzenia.

Zapis JSON 
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Pola
timePeriod

object (EventPeriodRange)

Okres objęty tą aktualizacją.
updates[]

object (EventUpdateRequest)

Aktualizacje dokonane w tym okresie.
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#eventPeriodUpdate.

EventPeriodRange

Zakres czasowy zdarzenia.

Zapis JSON 
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#eventPeriodRange.
periodStartMillis

string (int64 format)

Godzina rozpoczęcia tego okresu aktualizacji (w milisekundach) od 1970 roku czasu UTC (epoka uniksowa).
periodEndMillis

string (int64 format)

Godzina zakończenia tego okresu aktualizacji w milisekundach od 1970 roku czasu UTC (epoka uniksowa).

EventUpdateRequest

Zasób do aktualizowania okresu wydarzenia.

Zapis JSON 
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
Pola
definitionId

string

Identyfikator wydarzenia modyfikowanego w ramach tej aktualizacji.
updateCount

string (int64 format)

Liczba przypadków wystąpienia tego zdarzenia w tym okresie.
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#eventUpdateRequest.

EventBatchRecordFailure

Zasób zawierający błąd aktualizacji zbiorczej.

Zapis JSON 
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
Pola
range

object (EventPeriodRange)

Zakres czasu, który został odrzucony; pusty w przypadku błędu dotyczącego całego żądania.
failureCause

enum (EventFailureCause)

Przyczyna niepowodzenia aktualizacji.
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#eventBatchRecordFailure.

EventFailureCause

Możliwe wartości przyczyny niepowodzenia zdarzenia.

Wartości w polu enum
TOO_LARGE Wysłano żądanie zbiorcze z większą liczbą zdarzeń niż jest dozwolone w jednej grupie.
TIME_PERIOD_EXPIRED Wsad został wysłany z danymi, których dane są zbyt daleko w przeszłości, aby można było je zapisać.
TIME_PERIOD_SHORT Wysłano wsad z zbyt krótkim zakresem czasu.
TIME_PERIOD_LONG Wysłano wsad z zbyt długim zakresem czasu.
ALREADY_UPDATED Podjęto próbę zarejestrowania grupy danych, która została już odnotowana.
RECORD_RATE_HIGH Podjęto próbę zarejestrowania danych szybciej, niż serwer zastosuje aktualizacje.

EventRecordFailure

Zasób błędu aktualizacji zdarzenia.

Zapis JSON 
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
Pola
eventId

string

Identyfikator zdarzenia, które nie zostało zaktualizowane.
failureCause

enum (EventUpdateFailureCause)

Przyczyna niepowodzenia aktualizacji.
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#eventRecordFailure.

EventUpdateFailureCause

Możliwe wartości przyczyny niepowodzenia aktualizacji wydarzenia.

Wartości w polu enum
NOT_FOUND Podjęto próbę ustawienia niezdefiniowanego zdarzenia.
INVALID_UPDATE_VALUE Podjęto próbę zwiększenia zdarzenia o wartość niedodatnią.