- 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ébalo
Enumera el progreso de todos los logros de la aplicación para el jugador autenticado actualmente.
Solicitud HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
Parámetros de ruta
Parámetros | |
---|---|
playerId |
Un ID de jugador Se puede usar un valor de |
Parámetros de consulta
Parámetros | |
---|---|
language |
El idioma preferido para las cadenas que muestra este método. |
maxResults |
La cantidad máxima de recursos de logros que se deben mostrar en la respuesta, que 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 los logros con el estado especificado. Si no se especifica este parámetro, se mostrarán 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 es siempre la cadena fija |
nextPageToken |
Token que corresponde a la siguiente página de resultados. |
items[] |
Los logros |
Alcances de autorización
Se necesita 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.
Estado
Enumeraciones | |
---|---|
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
Es 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 es siempre la cadena fija |
id |
Es el ID del logro. |
currentSteps |
Los pasos actuales para un logro incremental. |
formattedCurrentStepsString |
Los pasos actuales para un logro incremental como una cadena. |
achievementState |
El estado del logro. |
lastUpdatedTimestamp |
La marca de tiempo de la última modificación del estado de este logro. |
experiencePoints |
Puntos de experiencia obtenidos por el logro. Este campo está ausente para los logros que aún no se han desbloqueado y 0 para los logros que los verificadores han desbloqueado, pero que no se publicaron. |
Estado
Define los posibles estados de un logro.
Enumeraciones | |
---|---|
HIDDEN |
El logro está oculto. |
REVEALED |
El logro se revela. |
UNLOCKED |
El logro está desbloqueado. |