Method: events.record

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

string

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 (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

Eventuali errori a livello di batch che si sono verificati durante l'applicazione degli aggiornamenti.
eventFailures[]

object (EventRecordFailure)

Eventuali errori durante l'aggiornamento di un determinato evento.
playerEvents[]

object (PlayerEvent)

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 (EventPeriodUpdate)
    }
  ]
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#eventRecordRequest.
requestId

string (int64 format)

L'ID richiesta utilizzato per identificare questo tentativo di registrare gli eventi.
currentTimeMillis

string (int64 format)

L'ora attuale di invio dell'aggiornamento, in millisecondi, dal 1970 UTC (Epoch Unix).
timePeriods[]

object (EventPeriodUpdate)

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 (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Campi
timePeriod

object (EventPeriodRange)

Il periodo di tempo interessato da questo aggiornamento.
updates[]

object (EventUpdateRequest)

Gli aggiornamenti apportati per questo periodo di tempo.
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#eventPeriodUpdate.

EventPeriodRange

Un intervallo di tempo del periodo dell'evento.

Rappresentazione JSON 
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#eventPeriodRange.
periodStartMillis

string (int64 format)

L'ora di inizio del periodo di aggiornamento, in millisecondi, dal 1970 UTC (Epoca Unix).
periodEndMillis

string (int64 format)

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

string

L'ID dell'evento modificato in questo aggiornamento.
updateCount

string (int64 format)

Il numero di volte in cui si è verificato l'evento nel periodo di tempo specificato.
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#eventUpdateRequest.

EventBatchRecordFailure

Una risorsa di errore di aggiornamento batch.

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

object (EventPeriodRange)

L'intervallo di tempo che è stato rifiutato. vuoto per un errore a livello di richiesta.
failureCause

enum (EventFailureCause)

La causa dell'errore di aggiornamento.
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#eventBatchRecordFailure.

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 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 (EventUpdateFailureCause),
  "kind": string
}
Campi
eventId

string

L'ID dell'evento che non è stato aggiornato.
failureCause

enum (EventUpdateFailureCause)

La causa dell'errore di aggiornamento.
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#eventRecordFailure.

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.