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 ricerca

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 eventi.
currentTimeMillis

string (int64 format)

L'ora corrente in cui l'aggiornamento è stato inviato, in millisecondi, dal 1970 UTC (Unix Epoch).
timePeriods[]

object (EventPeriodUpdate)

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

object (EventPeriodRange)

Il periodo di tempo coperto 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 di un 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 in cui inizia questo periodo di aggiornamento, in millisecondi, dal 1970 UTC (Unix Epoch).
periodEndMillis

string (int64 format)

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

string

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

string (int64 format)

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

string

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

EventBatchRecordFailure

Una risorsa non riuscita di aggiornamento batch.

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

object (EventPeriodRange)

L'intervallo di tempo 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 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 (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 non definito.
INVALID_UPDATE_VALUE È stato effettuato un tentativo di incrementare un evento in base a un valore non positivo.