Method: stats.get
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra estadísticas de participación y gastos en esta aplicación para el usuario autenticado actualmente.
Solicitud HTTP
GET https://games.googleapis.com/games/v1/stats
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Un recurso de estadísticas de terceros.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación 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
} |
| Campos |
churn_probability |
number
Es la probabilidad de que el jugador no vuelva a jugar al día siguiente. P. ej.: 0, 0.1, 0.5, …, 1.0. No se propaga si no hay suficiente información.
|
num_purchases |
integer
Cantidad de compras directas del jugador desde la aplicación en este juego. P. ej.: 0, 1, 5, 10, … No se propaga si no hay suficiente información.
|
spend_percentile |
number
Es el percentil de gasto aproximado del jugador en este partido. P. ej.: 0, 0.25, 0.5, 0.75. No se propaga si no hay suficiente información.
|
days_since_last_played |
integer
Es la cantidad de días desde la última vez que el usuario jugó este juego. P. ej.: 0, 1, 5, 10, … No se propaga si no hay suficiente información.
|
num_sessions |
integer
Es la cantidad aproximada de sesiones del jugador en los últimos 28 días, donde una sesión comienza cuando el jugador se conecta a los servicios de Play Juegos y finaliza cuando se desconecta. P. ej.: 0, 1, 5, 10, … No se propaga si no hay suficiente información.
|
num_sessions_percentile |
number
Es la aproximación del porcentaje de sesiones del jugador en los últimos 30 días, donde una sesión comienza cuando el jugador se conecta a los Servicios de juego de Play y finaliza cuando se desconecta. P. ej.: 0, 0.25, 0.5, 0.75. No se propaga si no hay suficiente información.
|
avg_session_length_minutes |
number
Es la duración promedio de la sesión en minutos del jugador. P. ej.: 1, 30, 60, … No se propaga si no hay suficiente información.
|
spend_probability |
number
Es la probabilidad de que el jugador compre el juego en los próximos siete días. P. ej.: 0, 0.25, 0.50, 0.75. No se propaga si no hay suficiente información.
|
high_spender_probability |
number
Es la probabilidad de que el jugador gaste más allá de un umbral de dinero. P. ej.: 0, 0.25, 0.50, 0.75. No se propaga si no hay suficiente información.
|
total_spend_next_28_days |
number
Es la cantidad de dinero prevista que el jugador gastará en los próximos 28 días. P. ej.: 1, 30, 60, … No se propaga si no hay suficiente información.
|
kind |
string
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija games#statsResponse.
|
Permisos de autorización
Se requiere uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Para obtener más información, consulta la descripción general de OAuth 2.0.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)."]]
