- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Estado
- PlayerAchievement
- Estado
- Pruébala
Enumera el progreso de todos los logros de tu aplicación correspondientes al jugador actualmente autenticado.
Solicitud HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
Parámetros de ruta de acceso
Parámetros | |
---|---|
playerId |
Un ID de jugador Se puede usar un valor de |
Parámetros de consulta
Parámetros | |
---|---|
language |
El idioma preferido para usar en las cadenas que muestra este método. |
maxResults |
La cantidad máxima de recursos de logros que se mostrarán en la respuesta. Se usa para la paginación. Para cualquier respuesta, la cantidad real de recursos de logros que se muestran puede ser menor que el |
pageToken |
El token que muestra la solicitud anterior. |
state |
Indica al servidor que muestre solo logros con el estado especificado. Si no se especifica este parámetro, se muestran todos los logros. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Una lista de objetos de logros.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
Campos | |
---|---|
kind |
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija |
nextPageToken |
El token correspondiente a la siguiente página de resultados. |
items[] |
Los logros |
Permisos de autorización
Se necesita uno de los siguientes alcances 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.
Estado
Enumeradores | |
---|---|
ALL |
Enumera todos los logros. Esta es la opción predeterminada. |
HIDDEN |
Enumera solo los logros ocultos. |
REVEALED |
Enumera solo los logros revelados. |
UNLOCKED |
Enumera solo los logros desbloqueados. |
PlayerAchievement
Un objeto de logro.
Representación JSON |
---|
{
"kind": string,
"id": string,
"currentSteps": integer,
"formattedCurrentStepsString": string,
"achievementState": enum ( |
Campos | |
---|---|
kind |
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija |
id |
Es el ID del logro. |
currentSteps |
Los pasos actuales para un logro incremental. |
formattedCurrentStepsString |
Son los pasos actuales para un logro incremental como una cadena. |
achievementState |
Es el estado del logro. |
lastUpdatedTimestamp |
Es la marca de tiempo de la última modificación del estado de este logro. |
experiencePoints |
Puntos de experiencia ganados por el logro. Este campo no aparece en el caso de los logros que aún no se desbloquearon y 0 para los que los verificadores desbloquearon, pero que no se publicaron. |
Estado
Define los estados posibles de un logro.
Enumeradores | |
---|---|
HIDDEN |
El logro está oculto. |
REVEALED |
Se revela el logro. |
UNLOCKED |
El logro está desbloqueado. |