- 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 query
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 gli eventi. |
currentTimeMillis |
L'ora attuale di invio dell'aggiornamento, in millisecondi, dal 1970 UTC (Epoch Unix). |
timePeriods[] |
Un elenco degli aggiornamenti del periodo di tempo apportati in questa richiesta. |
EventPeriodUpdate
Una risorsa di aggiornamento del periodo dell'evento.
Rappresentazione JSON |
---|
{ "timePeriod": { object ( |
Campi | |
---|---|
timePeriod |
Il periodo di tempo interessato 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 dell'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 di inizio del periodo di aggiornamento, in millisecondi, dal 1970 UTC (Epoca Unix). |
periodEndMillis |
L'ora di fine del periodo di aggiornamento, in millisecondi, dal 1970 UTC (Epoca Unix). |
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 si è verificato questo evento nel periodo di tempo specificato. |
kind |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa |
EventBatchRecordFailure
Una risorsa di errore di aggiornamento batch.
Rappresentazione JSON |
---|
{ "range": { object ( |
Campi | |
---|---|
range |
L'intervallo di tempo che è stato 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 errore di evento.
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 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 effettuato un tentativo di registrare un batch di dati che era già stato rilevato. |
RECORD_RATE_HIGH |
È stato effettuato un tentativo di registrare i dati più velocemente dell'applicazione degli aggiornamenti da parte del server. |
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 che non è stato definito. |
INVALID_UPDATE_VALUE |
È stato effettuato un tentativo di incrementare un evento di un valore non positivo. |