Method: events.record

Rejestruje grupę zmian liczby wystąpień zdarzeń w przypadku aktualnie 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 znaków zwracanych przez tę metodę.

Treść żądania

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

Treść odpowiedzi

Zasób aktualizacji okresu zdarzenia.

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ścią jest zawsze stały ciąg znaków games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

Wszelkie błędy obejmujące cały wsad, podczas których podczas stosowania aktualizacji wystąpiły błędy.
eventFailures[]

object (EventRecordFailure)

Nie udało się zaktualizować konkretnego wydarzenia.
playerEvents[]

object (PlayerEvent)

Bieżący stan wszystkich zaktualizowanych wydarzeń

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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 aktualizacji okresu zdarzenia.

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

string

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

string (int64 format)

Identyfikator żądania używany do identyfikacji tej próby rejestrowania zdarzeń.
currentTimeMillis

string (int64 format)

Obecna godzina wysłania tej aktualizacji (w milisekundach), od 1970 roku (UTC, epoka uniksowa).
timePeriods[]

object (EventPeriodUpdate)

Lista zmian w przedziale czasu wprowadzanym w ramach tej prośby.

EventPeriodUpdate

Zasób aktualizacji okresu zdarzenia.

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

object (EventPeriodRange)

Przedział czasu, którego dotyczy ta aktualizacja.
updates[]

object (EventUpdateRequest)

Zmiany wprowadzone w tym okresie.
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg 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ścią jest zawsze stały ciąg znaków games#eventPeriodRange.
periodStartMillis

string (int64 format)

Godzina rozpoczęcia tego okresu aktualizacji (w milisekundach), od początku 1970 r. czasu UTC (epoka uniksowa).
periodEndMillis

string (int64 format)

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

EventUpdateRequest

Zasób aktualizacji okresu zdarzenia.

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

string

Identyfikator wydarzenia zmodyfikowanego w tej aktualizacji.
updateCount

string (int64 format)

Liczba wystąpień tego zdarzenia w tym okresie.
kind

string

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

EventBatchRecordFailure

Zasób niepowodzenia aktualizacji wsadowej.

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

object (EventPeriodRange)

zakres czasu, który został odrzucony; puste w przypadku błędu obejmującego całe żądanie.
failureCause

enum (EventFailureCause)

Przyczyna niepowodzenia aktualizacji.
kind

string

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

EventFailureCause

Możliwe wartości przyczyny niepowodzenia zdarzenia.

Wartości w polu enum
TOO_LARGE Przesłano żądanie zbiorcze z większą liczbą zdarzeń, niż jest dozwolona w jednej grupie.
TIME_PERIOD_EXPIRED Wysłano partię z danymi zbyt odległymi w przeszłości, aby je zapisać.
TIME_PERIOD_SHORT Wysłano grupę ze zbyt krótkim zakresem czasu.
TIME_PERIOD_LONG Wysłano grupę ze zbyt długim zakresem czasu.
ALREADY_UPDATED Podjęto próbę zarejestrowania grupy danych, która została już zarejestrowana.
RECORD_RATE_HIGH Podjęto próbę zarejestrowania danych szybciej, niż serwer zastosuje aktualizacje.

EventRecordFailure

Zasób niepowodzenia aktualizacji zdarzenia.

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

string

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

enum (EventUpdateFailureCause)

Przyczyna niepowodzenia aktualizacji.
kind

string

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

EventUpdateFailureCause

Możliwe wartości przyczyny niepowodzenia aktualizacji zdarzenia.

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