- Solicitação HTTP
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Faça um teste
Registra um lote de alterações no número de vezes que os eventos ocorreram para o usuário atualmente autenticado deste aplicativo.
Solicitação HTTP
POST https://games.googleapis.com/games/v1/events
Parâmetros de consulta
Parâmetros | |
---|---|
language |
O idioma preferido a ser usado para strings retornadas por esse método. |
Corpo da solicitação
O corpo da solicitação contém uma instância de EventsUpdates
.
Corpo da resposta
Um recurso de atualização do período do evento.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{ "kind": string, "batchFailures": [ { object ( |
Campos | |
---|---|
kind |
Identifica exclusivamente o tipo deste recurso. O valor é sempre a string fixa |
batchFailures[] |
Todas as falhas em todo o lote que ocorreram ao aplicar atualizações. |
eventFailures[] |
Qualquer falha ao atualizar um evento específico. |
playerEvents[] |
O status atual de qualquer evento atualizado |
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Para mais informações, consulte a Visão geral do OAuth 2.0.
EventsUpdates
Um recurso de atualização do período do evento.
Representação JSON |
---|
{
"kind": string,
"requestId": string,
"currentTimeMillis": string,
"timePeriods": [
{
object ( |
Campos | |
---|---|
kind |
Identifica exclusivamente o tipo deste recurso. O valor é sempre a string fixa |
requestId |
O ID da solicitação usado para identificar essa tentativa de registrar eventos. |
currentTimeMillis |
A hora atual em que esta atualização foi enviada, em milissegundos, desde 1970 UTC (Unix Epoch). |
timePeriods[] |
Uma lista das atualizações do período que estão sendo feitas nesta solicitação. |
EventPeriodUpdate
Um recurso de atualização do período do evento.
Representação JSON |
---|
{ "timePeriod": { object ( |
Campos | |
---|---|
timePeriod |
O período abrangido por esta atualização. |
updates[] |
As atualizações que estão sendo feitas para este período. |
kind |
Identifica exclusivamente o tipo deste recurso. O valor é sempre a string fixa |
EventPeriodRange
Um intervalo de tempo do período do evento.
Representação JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Campos | |
---|---|
kind |
Identifica exclusivamente o tipo deste recurso. O valor é sempre a string fixa |
periodStartMillis |
A hora em que o período de atualização começa, em milissegundos, desde 1970 UTC (Unix Epoch). |
periodEndMillis |
É a hora em que o período de atualização termina, em milissegundos, desde 1970 UTC (Unix Epoch). |
EventUpdateRequest
Um recurso de atualização do período do evento.
Representação JSON |
---|
{ "definitionId": string, "updateCount": string, "kind": string } |
Campos | |
---|---|
definitionId |
O ID do evento que está sendo modificado nessa atualização. |
updateCount |
O número de vezes que o evento ocorreu nesse período. |
kind |
Identifica exclusivamente o tipo deste recurso. O valor é sempre a string fixa |
EventBatchRecordFailure
Um recurso de falha na atualização em lote.
Representação JSON |
---|
{ "range": { object ( |
Campos | |
---|---|
range |
O período que foi rejeitado. vazio para uma falha em toda a solicitação. |
failureCause |
A causa da falha na atualização. |
kind |
Identifica exclusivamente o tipo deste recurso. O valor é sempre a string fixa |
EventFailureCause
Valores possíveis para uma causa de falha no evento.
Enums | |
---|---|
TOO_LARGE |
Uma solicitação em lote foi emitida com mais eventos do que são permitidos em um único lote. |
TIME_PERIOD_EXPIRED |
Um lote foi enviado com dados muito antigos para serem registrados. |
TIME_PERIOD_SHORT |
Um lote foi enviado com um período muito curto. |
TIME_PERIOD_LONG |
Um lote foi enviado com um período muito longo. |
ALREADY_UPDATED |
Houve uma tentativa de registrar um lote de dados que já tinha sido visto. |
RECORD_RATE_HIGH |
Foi feita uma tentativa de gravar dados mais rapidamente do que o servidor vai aplicar as atualizações. |
EventRecordFailure
Um recurso de falha na atualização de eventos.
Representação JSON |
---|
{
"eventId": string,
"failureCause": enum ( |
Campos | |
---|---|
eventId |
O ID do evento que não foi atualizado. |
failureCause |
A causa da falha na atualização. |
kind |
Identifica exclusivamente o tipo deste recurso. O valor é sempre a string fixa |
EventUpdateFailureCause
Valores possíveis para a causa de uma falha na atualização do evento.
Enums | |
---|---|
NOT_FOUND |
Houve uma tentativa de configurar um evento que não foi definido. |
INVALID_UPDATE_VALUE |
Foi feita uma tentativa de incrementar um evento com um valor não positivo. |