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 privilégiée pour les chaînes renvoyées par cette méthode.

Corps de la requête

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

Corps de la réponse

Ressource de mise à jour de la période de l'é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 qui se sont produits lors de l'application des mises à jour.
eventFailures[]

object (EventRecordFailure)

Échec de la 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 la période de l'é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 utilisé pour identifier cette tentative d'enregistrement d'événements.
currentTimeMillis

string (int64 format)

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

object (EventPeriodUpdate)

Liste des mises à jour de la période qui sont effectuées dans cette requête.

EventPeriodUpdate

Ressource de mise à jour de la période de l'é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 effectuées 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 correspondant à la période de l'é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 de début de la période de mise à jour, exprimée en millisecondes, depuis 1970 UTC (epoch Unix).
periodEndMillis

string (int64 format)

Heure de fin de cette période de mise à jour, exprimée en millisecondes, depuis 1970 UTC (epoch Unix).

EventUpdateRequest

Ressource de mise à jour de la période de l'é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 groupée.

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

object (EventPeriodRange)

La période qui a été refusée vide en cas d'échec de l'ensemble 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 une cause d'échec de l'événement.

Enums
TOO_LARGE Une requête par lot a été émise avec plus d'événements que ceux autorisés dans un seul lot.
TIME_PERIOD_EXPIRED Un lot a été envoyé avec des données trop anciennes pour être enregistrées.
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à affiché.
RECORD_RATE_HIGH Une tentative d'enregistrement des données a été effectuée 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 l'origine 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.