Method: stats.get
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie des statistiques sur l'engagement et les dépenses dans cette application pour l'utilisateur actuellement authentifié.
Requête HTTP
GET https://games.googleapis.com/games/v1/stats
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Une ressource de statistiques tierce.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"churn_probability": number,
"num_purchases": integer,
"spend_percentile": number,
"days_since_last_played": integer,
"num_sessions": integer,
"num_sessions_percentile": number,
"avg_session_length_minutes": number,
"spend_probability": number,
"high_spender_probability": number,
"total_spend_next_28_days": number,
"kind": string
} |
| Champs |
churn_probability |
number
Probabilité que le joueur ne revienne pas au jeu le lendemain. Exemple : 0, 0,1, 0,5, ..., 1,0. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
num_purchases |
integer
Nombre d'achats via une application effectués par le joueur dans ce jeu. Exemple : 0, 1, 5, 10, etc. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
spend_percentile |
number
Centile approximatif des dépenses du joueur dans ce jeu. Exemple : 0, 0,25, 0,5, 0,75. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
days_since_last_played |
integer
Nombre de jours écoulés depuis la dernière partie du joueur Exemple : 0, 1, 5, 10, etc. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
num_sessions |
integer
Nombre approximatif de sessions du joueur au cours des 28 derniers jours. Une session commence lorsque le joueur est connecté aux services de jeux Play et se termine lorsqu'il est déconnecté. Exemple : 0, 1, 5, 10, etc. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
num_sessions_percentile |
number
Estimation du centile des sessions du joueur au cours des 30 derniers jours. Une session commence lorsque le joueur est connecté aux services de jeux Play et se termine lorsqu'il est déconnecté. Exemple : 0, 0,25, 0,5, 0,75. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
avg_session_length_minutes |
number
Durée moyenne des sessions du joueur, en minutes Exemple : 1, 30, 60, etc. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
spend_probability |
number
Probabilité que le joueur effectue le jeu au cours des sept prochains jours. Exemple : 0, 0,25, 0,50, 0,75. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
high_spender_probability |
number
Probabilité que le joueur dépense au-delà d'un certain montant d'argent. Exemple : 0, 0,25, 0,50, 0,75. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
total_spend_next_28_days |
number
Il s'agit du montant prévu que le joueur dépensera au cours des 28 prochains jours. Exemple : 1, 30, 60, etc. Ce champ n'est pas renseigné si les informations sont insuffisantes.
|
kind |
string
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#statsResponse.
|
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.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# Method: stats.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.PlayerStats.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns engagement and spend statistics in this application for the currently authenticated user.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/stats`\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA third party stats resource.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"churn_probability\": number, \"num_purchases\": integer, \"spend_percentile\": number, \"days_since_last_played\": integer, \"num_sessions\": integer, \"num_sessions_percentile\": number, \"avg_session_length_minutes\": number, \"spend_probability\": number, \"high_spender_probability\": number, \"total_spend_next_28_days\": number, \"kind\": string } ``` |\n\n| Fields ||\n|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `churn_probability` | `number` The probability of the player not returning to play the game in the next day. E.g., 0, 0.1, 0.5, ..., 1.0. Not populated if there is not enough information. |\n| `num_purchases` | `integer` Number of in-app purchases made by the player in this game. E.g., 0, 1, 5, 10, ... . Not populated if there is not enough information. |\n| `spend_percentile` | `number` The approximate spend percentile of the player in this game. E.g., 0, 0.25, 0.5, 0.75. Not populated if there is not enough information. |\n| `days_since_last_played` | `integer` Number of days since the player last played this game. E.g., 0, 1, 5, 10, ... . Not populated if there is not enough information. |\n| `num_sessions` | `integer` The approximate number of sessions of the player within the last 28 days, where a session begins when the player is connected to Play Games Services and ends when they are disconnected. E.g., 0, 1, 5, 10, ... . Not populated if there is not enough information. |\n| `num_sessions_percentile` | `number` The approximation of the sessions percentile of the player within the last 30 days, where a session begins when the player is connected to Play Games Services and ends when they are disconnected. E.g., 0, 0.25, 0.5, 0.75. Not populated if there is not enough information. |\n| `avg_session_length_minutes` | `number` Average session length in minutes of the player. E.g., 1, 30, 60, ... . Not populated if there is not enough information. |\n| `spend_probability` | `number` The probability of the player going to spend the game in the next seven days. E.g., 0, 0.25, 0.50, 0.75. Not populated if there is not enough information. |\n| `high_spender_probability` | `number` The probability of the player going to spend beyond a threshold amount of money. E.g., 0, 0.25, 0.50, 0.75. Not populated if there is not enough information. |\n| `total_spend_next_28_days` | `number` The predicted amount of money that the player going to spend in the next 28 days. E.g., 1, 30, 60, ... . Not populated if there is not enough information. |\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#statsResponse`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
