Method: events.record

Enregistre un lot de modifications du nombre de fois où des événements se sont produits pour l'utilisateur actuellement authentifié de cette application.

Requête HTTP

POST https://games.googleapis.com/games/v1/events

Paramètres de requête

Paramètres
language

string

Langue préférée à utiliser pour les chaînes renvoyées par cette méthode.

Corps de la requête

Le corps de la requête contient une instance EventsUpdates.

Corps de la réponse

Ressource de mise à jour de période d'événement.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#eventUpdateResponse.
batchFailures[]

object (EventBatchRecordFailure)

Échecs à l'échelle du lot survenus lors de l'application des mises à jour.
eventFailures[]

object (EventRecordFailure)

Tous les échecs de mise à jour d'un événement particulier.
playerEvents[]

object (PlayerEvent)

l'état actuel des événements mis à jour ;

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

EventsUpdates

Ressource de mise à jour de période d'événement.

Représentation JSON 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#eventRecordRequest.
requestId

string (int64 format)

ID de requête permettant d'identifier cette tentative d'enregistrement d'événements.
currentTimeMillis

string (int64 format)

Heure actuelle à laquelle cette mise à jour a été envoyée, en millisecondes, depuis 1970 UTC (Unix Epoch).
timePeriods[]

object (EventPeriodUpdate)

Liste des modifications apportées à la période pour cette requête.

EventPeriodUpdate

Ressource de mise à jour de période d'événement.

Représentation JSON 
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
Champs
timePeriod

object (EventPeriodRange)

Période couverte par cette mise à jour.
updates[]

object (EventUpdateRequest)

Mises à jour en cours pour cette période.
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#eventPeriodUpdate.

EventPeriodRange

Période d'une période d'événement.

Représentation JSON 
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#eventPeriodRange.
periodStartMillis

string (int64 format)

Heure à laquelle cette période de mise à jour commence, en millisecondes, depuis 1970 UTC (epoch Unix).
periodEndMillis

string (int64 format)

Heure à laquelle cette période de mise à jour se termine, en millisecondes, depuis 1970 UTC (epoch Unix).

EventUpdateRequest

Ressource de mise à jour de période d'événement.

Représentation JSON 
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
Champs
definitionId

string

ID de l'événement en cours de modification dans cette mise à jour.
updateCount

string (int64 format)

Nombre de fois où cet événement s'est produit au cours de cette période.
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#eventUpdateRequest.

EventBatchRecordFailure

Ressource associée à un échec de mise à jour par lot.

Représentation JSON 
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
Champs
range

object (EventPeriodRange)

Période ayant été refusée ; vide en cas d'échec à l'échelle de la requête.
failureCause

enum (EventFailureCause)

Cause de l'échec de la mise à jour.
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#eventBatchRecordFailure.

EventFailureCause

Valeurs possibles pour la cause de l'échec d'un événement.

Enums
TOO_LARGE Une requête groupée a été émise avec plus d'événements que la limite autorisée dans un seul lot.
TIME_PERIOD_EXPIRED Un lot contenant des données trop anciennes pour être enregistrés a été envoyé.
TIME_PERIOD_SHORT Un lot a été envoyé avec une période trop courte.
TIME_PERIOD_LONG Un lot a été envoyé avec une période trop longue.
ALREADY_UPDATED Tentative d'enregistrement d'un lot de données déjà vue.
RECORD_RATE_HIGH Tentative d'enregistrement des données plus rapidement que le serveur n'appliquera les mises à jour.

EventRecordFailure

Ressource d'échec de mise à jour d'événement.

Représentation JSON 
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
Champs
eventId

string

ID de l'événement qui n'a pas été mis à jour.
failureCause

enum (EventUpdateFailureCause)

Cause de l'échec de la mise à jour.
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#eventRecordFailure.

EventUpdateFailureCause

Valeurs possibles pour la cause de l'échec de la mise à jour d'un événement.

Enums
NOT_FOUND Tentative de définition d'un événement non défini.
INVALID_UPDATE_VALUE Tentative d'incrémentation d'un événement d'une valeur non positive.