Google Play Game Services

Los servicios de juego de Google Play permiten a los desarrolladores mejorar los juegos con tablas de clasificación sociales, logros, estado del juego, acceso con Google y mucho más.

Servicio: games.googleapis.com

Para llamar a este servicio, te recomendamos que uses las bibliotecas cliente que proporciona Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la siguiente información cuando realices las solicitudes a la API.

Documento de descubrimiento

Un Documento de descubrimiento es una especificación procesable para describir y consumir las APIs de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las APIs de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona el siguiente documento de descubrimiento:

Endpoint de servicio

Un endpoint de servicio es una URL base que especifica la dirección de red de un servicio de API. Un servicio puede tener múltiples endpoints. Este servicio tiene el siguiente endpoint, y todos los URIs que se muestran a continuación están relacionados con él:

  • https://games.googleapis.com

Recurso de REST: accesstokens

Métodos
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Genera un token de la API de Play Grouping para el usuario de los PGS identificado por la credencial adjunta.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Genera un token de la API de Play Grouping para el usuario de los PGS identificado por el ID de sesión de Recall proporcionado en la solicitud.

Recurso de REST: achievementDefinitions

Métodos
list GET /games/v1/achievements
Enumera todas las definiciones de logros de tu aplicación.

Recurso de REST: achievements

Métodos
increment POST /games/v1/achievements/{achievementId}/increment
Incrementa los pasos del logro con el ID determinado para el jugador autenticado actualmente.
list GET /games/v1/players/{playerId}/achievements
Muestra una lista del progreso de todos los logros de tu aplicación para el jugador autenticado actualmente.
reveal POST /games/v1/achievements/{achievementId}/reveal
Establece el estado del logro con el ID determinado en REVEALED para el jugador autenticado actualmente.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Establece los pasos que debe seguir el jugador autenticado actualmente para desbloquear un logro.
unlock POST /games/v1/achievements/{achievementId}/unlock
Desbloquea este logro para el jugador autenticado actualmente.
updateMultiple POST /games/v1/achievements/updateMultiple
Actualiza varios logros del jugador autenticado actualmente.

Recurso de REST: applications

Métodos
get GET /games/v1/applications/{applicationId}
Recupera los metadatos de la aplicación con el ID determinado.
getEndPoint POST /games/v1/applications/getEndPoint
Muestra una URL para el tipo de extremo solicitado.
played POST /games/v1/applications/played
Indica que el usuario autenticado actualmente está jugando tu aplicación.
verify GET /games/v1/applications/{applicationId}/verify
Verifica que el token de autenticación proporcionado con esta solicitud sea para la aplicación con el ID especificado y muestra el ID del jugador para el que se otorgó.

Recurso de REST: events

Métodos
listByPlayer GET /games/v1/events
Muestra una lista que muestra el progreso actual de los eventos en esta aplicación para el usuario autenticado actualmente.
listDefinitions GET /games/v1/eventDefinitions
Muestra una lista de las definiciones de eventos en esta aplicación.
record POST /games/v1/events
Registra un lote de cambios en la cantidad de veces que ocurrieron eventos para el usuario autenticado actualmente de esta aplicación.

Recurso de REST: leaderboards

Métodos
get GET /games/v1/leaderboards/{leaderboardId}
Recupera los metadatos de la tabla de clasificación con el ID determinado.
list GET /games/v1/leaderboards
Muestra todos los metadatos de la tabla de clasificación de tu aplicación.

Recurso de REST: metagame

Métodos
getMetagameConfig GET /games/v1/metagameConfig
Muestra los datos de configuración del metajuego para la aplicación que realiza la llamada.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Muestra los datos de reproducción agregados por categoría del jugador correspondiente a playerId.

Recurso de REST: players

Métodos
get GET /games/v1/players/{playerId}
Recupera el recurso de jugador con el ID determinado.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Obtén los IDs de jugador de la aplicación para el jugador autenticado actualmente en todos los juegos solicitados por el mismo desarrollador que la aplicación que realiza la llamada.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Recupera los identificadores de jugador centrados para el usuario autenticado actualmente.
list GET /games/v1/players/me/players/{collection}
Obtén la colección de jugadores del usuario autenticado actualmente.

Recurso de REST: recall

Métodos
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Recupera los tokens de recuperación de todos los juegos solicitados que estén asociados con el jugador de los PGS codificado en el ID de sesión de recuperación proporcionado.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Recupera el último token de recuperación de todos los juegos del desarrollador asociados con el jugador de los PGS codificado en el ID de sesión de recuperación proporcionado.
linkPersona POST /games/v1/recall:linkPersona
Asocia el principal de jugador de los PGS codificado en el ID de sesión de recuperación proporcionado con una cuenta en el juego
resetPersona POST /games/v1/recall:resetPersona
Borra todos los tokens de Recall que vinculan el arquetipo determinado a cualquier jugador (con o sin un perfil).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Recupera todos los tokens de recuperación asociados con el reproductor de los PGS codificados en el ID de sesión de recuperación proporcionado.
unlinkPersona POST /games/v1/recall:unlinkPersona
Borra un token de recuperación que vincula el principal del jugador de los PGS identificado por la sesión de recuperación y una cuenta en el juego identificada por el "arquetipo" o por el valor del token.

Recurso de REST: revisions

Métodos
check GET /games/v1/revisions/check
Verifica si el cliente de juegos está desactualizado.

Recurso de REST: scores

Métodos
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Obtén puntuaciones altas y, de manera opcional, clasificaciones en las tablas de clasificación del jugador autenticado actualmente.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Muestra las puntuaciones en una tabla de clasificación, comenzando desde la parte superior.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Muestra las puntuaciones en una tabla de clasificación alrededor de la puntuación de un jugador (incluida esta).
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Envía una puntuación a la tabla de clasificación especificada.
submitMultiple POST /games/v1/leaderboards/scores
Envía varias puntuaciones a las tablas de clasificación.

Recurso de REST: snapshots

Métodos
get GET /games/v1/snapshots/{snapshotId}
Recupera los metadatos de un ID de instantánea determinado.
list GET /games/v1/players/{playerId}/snapshots
Recupera una lista de instantáneas que creó tu aplicación para el jugador correspondiente al ID de jugador.

Recurso de REST: stats

Métodos
get GET /games/v1/stats
Muestra las estadísticas de participación y gasto en esta aplicación para el usuario autenticado actualmente.