- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- EventsUpdates
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- EventPeriodUpdate
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- EventPeriodRange
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- EventUpdateRequest
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- EventBatchRecordFailure
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- EventFailureCause
- EventRecordFailure
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- EventUpdateFailureCause
- Essayer
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 |
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 ( |
Champs | |
---|---|
kind |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe |
batchFailures[] |
Échecs à l'échelle du lot qui se sont produits lors de l'application des mises à jour. |
eventFailures[] |
Échec de la mise à jour d'un événement particulier. |
playerEvents[] |
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 ( |
Champs | |
---|---|
kind |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe |
requestId |
ID de requête utilisé pour identifier cette tentative d'enregistrement d'événements. |
currentTimeMillis |
Heure actuelle, en millisecondes, à laquelle cette mise à jour a été envoyée depuis 1970 UTC (epoch Unix). |
timePeriods[] |
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 ( |
Champs | |
---|---|
timePeriod |
Période couverte par cette mise à jour. |
updates[] |
Mises à jour effectuées pour cette période. |
kind |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe |
EventPeriodRange
Période correspondant à la période de l'événement.
Représentation JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Champs | |
---|---|
kind |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe |
periodStartMillis |
Heure de début de la période de mise à jour, exprimée en millisecondes, depuis 1970 UTC (epoch Unix). |
periodEndMillis |
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 |
ID de l'événement en cours de modification dans cette mise à jour. |
updateCount |
Nombre de fois où cet événement s'est produit au cours de cette période. |
kind |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe |
EventBatchRecordFailure
Ressource associée à un échec de mise à jour groupée.
Représentation JSON |
---|
{ "range": { object ( |
Champs | |
---|---|
range |
La période qui a été refusée vide en cas d'échec de l'ensemble de la requête. |
failureCause |
Cause de l'échec de la mise à jour. |
kind |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe |
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 ( |
Champs | |
---|---|
eventId |
ID de l'événement qui n'a pas été mis à jour. |
failureCause |
Cause de l'échec de la mise à jour. |
kind |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe |
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. |