- Żądanie HTTP
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange.
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Wypróbuj
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 |
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 ( |
Pola | |
---|---|
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków |
batchFailures[] |
Wszystkie błędy wsadowe, które wystąpiły podczas stosowania aktualizacji. |
eventFailures[] |
nieudane aktualizacje konkretnego wydarzenia; |
playerEvents[] |
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 ( |
Pola | |
---|---|
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków |
requestId |
Identyfikator żądania służący do identyfikacji tej próby nagrania zdarzeń. |
currentTimeMillis |
Bieżący czas wysłania tej aktualizacji (w milisekundach), od 1970 roku UTC (epoka uniksowa). |
timePeriods[] |
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 ( |
Pola | |
---|---|
timePeriod |
Okres objęty tą aktualizacją. |
updates[] |
Aktualizacje dokonane w tym okresie. |
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków |
EventPeriodRange
Zakres czasowy zdarzenia.
Zapis JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Pola | |
---|---|
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków |
periodStartMillis |
Godzina rozpoczęcia tego okresu aktualizacji (w milisekundach) od 1970 roku czasu UTC (epoka uniksowa). |
periodEndMillis |
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 |
Identyfikator wydarzenia modyfikowanego w ramach tej aktualizacji. |
updateCount |
Liczba przypadków wystąpienia tego zdarzenia w tym okresie. |
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków |
EventBatchRecordFailure
Zasób zawierający błąd aktualizacji zbiorczej.
Zapis JSON |
---|
{ "range": { object ( |
Pola | |
---|---|
range |
Zakres czasu, który został odrzucony; pusty w przypadku błędu dotyczącego całego żądania. |
failureCause |
Przyczyna niepowodzenia aktualizacji. |
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków |
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 ( |
Pola | |
---|---|
eventId |
Identyfikator zdarzenia, które nie zostało zaktualizowane. |
failureCause |
Przyczyna niepowodzenia aktualizacji. |
kind |
Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków |
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ą. |