- Żądanie HTTP
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Wypróbuj
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 |
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 ( |
Pola | |
---|---|
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
batchFailures[] |
Wszelkie błędy obejmujące cały wsad, podczas których podczas stosowania aktualizacji wystąpiły błędy. |
eventFailures[] |
Nie udało się zaktualizować konkretnego wydarzenia. |
playerEvents[] |
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 ( |
Pola | |
---|---|
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
requestId |
Identyfikator żądania używany do identyfikacji tej próby rejestrowania zdarzeń. |
currentTimeMillis |
Obecna godzina wysłania tej aktualizacji (w milisekundach), od 1970 roku (UTC, epoka uniksowa). |
timePeriods[] |
Lista zmian w przedziale czasu wprowadzanym w ramach tej prośby. |
EventPeriodUpdate
Zasób aktualizacji okresu zdarzenia.
Zapis JSON |
---|
{ "timePeriod": { object ( |
Pola | |
---|---|
timePeriod |
Przedział czasu, którego dotyczy ta aktualizacja. |
updates[] |
Zmiany wprowadzone w tym okresie. |
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
EventPeriodRange
Zakres czasowy zdarzenia.
Zapis JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Pola | |
---|---|
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
periodStartMillis |
Godzina rozpoczęcia tego okresu aktualizacji (w milisekundach), od początku 1970 r. czasu UTC (epoka uniksowa). |
periodEndMillis |
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 |
Identyfikator wydarzenia zmodyfikowanego w tej aktualizacji. |
updateCount |
Liczba wystąpień tego zdarzenia w tym okresie. |
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
EventBatchRecordFailure
Zasób niepowodzenia aktualizacji wsadowej.
Zapis JSON |
---|
{ "range": { object ( |
Pola | |
---|---|
range |
zakres czasu, który został odrzucony; puste w przypadku błędu obejmującego całe żądanie. |
failureCause |
Przyczyna niepowodzenia aktualizacji. |
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
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 ( |
Pola | |
---|---|
eventId |
Identyfikator wydarzenia, które nie zostało zaktualizowane. |
failureCause |
Przyczyna niepowodzenia aktualizacji. |
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków |
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ą. |