- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Prova!
Registra un gruppo di modifiche al numero di volte in cui si sono verificati eventi per l'utente attualmente autenticato di questa applicazione.
Richiesta HTTP
POST https://games.googleapis.com/games/v1/events
Parametri di ricerca
Parametri | |
---|---|
language |
La lingua preferita da utilizzare per le stringhe restituite da questo metodo. |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di EventsUpdates
.
Corpo della risposta
Una risorsa di aggiornamento del periodo dell'evento.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "kind": string, "batchFailures": [ { object ( |
Campi | |
---|---|
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
batchFailures[] |
Eventuali errori a livello di batch che si sono verificati durante l'applicazione degli aggiornamenti. |
eventFailures[] |
Eventuali errori durante l'aggiornamento di un determinato evento. |
playerEvents[] |
Lo stato attuale di eventuali eventi aggiornati |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
EventsUpdates
Una risorsa di aggiornamento del periodo dell'evento.
Rappresentazione JSON |
---|
{
"kind": string,
"requestId": string,
"currentTimeMillis": string,
"timePeriods": [
{
object ( |
Campi | |
---|---|
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
requestId |
L'ID richiesta utilizzato per identificare questo tentativo di registrare eventi. |
currentTimeMillis |
L'ora corrente in cui l'aggiornamento è stato inviato, in millisecondi, dal 1970 UTC (Unix Epoch). |
timePeriods[] |
Un elenco degli aggiornamenti relativi al periodo di tempo effettuati in questa richiesta. |
EventPeriodUpdate
Una risorsa di aggiornamento del periodo dell'evento.
Rappresentazione JSON |
---|
{ "timePeriod": { object ( |
Campi | |
---|---|
timePeriod |
Il periodo di tempo coperto da questo aggiornamento. |
updates[] |
Gli aggiornamenti apportati per questo periodo di tempo. |
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
EventPeriodRange
Un intervallo di tempo del periodo di un evento.
Rappresentazione JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Campi | |
---|---|
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
periodStartMillis |
L'ora in cui inizia questo periodo di aggiornamento, in millisecondi, dal 1970 UTC (Unix Epoch). |
periodEndMillis |
L'ora in cui termina il periodo di aggiornamento, in millisecondi, dal 1970 UTC (Unix Epoch). |
EventUpdateRequest
Una risorsa di aggiornamento del periodo dell'evento.
Rappresentazione JSON |
---|
{ "definitionId": string, "updateCount": string, "kind": string } |
Campi | |
---|---|
definitionId |
L'ID dell'evento modificato in questo aggiornamento. |
updateCount |
Il numero di volte in cui l'evento si è verificato in questo periodo di tempo. |
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
EventBatchRecordFailure
Una risorsa non riuscita di aggiornamento batch.
Rappresentazione JSON |
---|
{ "range": { object ( |
Campi | |
---|---|
range |
L'intervallo di tempo rifiutato; vuoto per un errore a livello di richiesta. |
failureCause |
La causa dell'errore di aggiornamento. |
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
EventFailureCause
Valori possibili per la causa di un evento non riuscito.
Enum | |
---|---|
TOO_LARGE |
È stata inviata una richiesta batch con più eventi di quelli consentiti in un singolo batch. |
TIME_PERIOD_EXPIRED |
È stato inviato un batch con dati troppo lontani nel passato per poter essere registrati. |
TIME_PERIOD_SHORT |
È stato inviato un batch con un intervallo di tempo troppo breve. |
TIME_PERIOD_LONG |
È stato inviato un batch con un intervallo di tempo troppo lungo. |
ALREADY_UPDATED |
È stato eseguito un tentativo di registrare un batch di dati già visualizzati. |
RECORD_RATE_HIGH |
È stato effettuato un tentativo di registrare i dati più velocemente di quanto il server applicherà gli aggiornamenti. |
EventRecordFailure
Una risorsa di errore di aggiornamento dell'evento.
Rappresentazione JSON |
---|
{
"eventId": string,
"failureCause": enum ( |
Campi | |
---|---|
eventId |
L'ID dell'evento che non è stato aggiornato. |
failureCause |
La causa dell'errore di aggiornamento. |
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
EventUpdateFailureCause
Valori possibili per la causa di un errore di aggiornamento di un evento.
Enum | |
---|---|
NOT_FOUND |
È stato effettuato un tentativo di impostare un evento non definito. |
INVALID_UPDATE_VALUE |
È stato effettuato un tentativo di incrementare un evento in base a un valore non positivo. |