Google Play Games Services API

El Servicio de juego de Google Play permite 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 información siguiente cuando realices las solicitudes a la API.

Documento de descubrimiento

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

Extremo 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
Enumera el 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 para que el jugador autenticado actualmente desbloquee 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
Devuelve una URL para el tipo de destino 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 autorización proporcionado con esta solicitud sea para la aplicación con el ID especificado y devuelve el ID del jugador para el que se otorgó.

Recurso de REST: events

Métodos
listByPlayer GET /games/v1/events
Devuelve una lista que muestra el progreso actual en los eventos de esta aplicación para el usuario autenticado actualmente.
listDefinitions GET /games/v1/eventDefinitions
Devuelve 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 se produjeron 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 del ranking con el ID determinado.
list GET /games/v1/leaderboards
Enumera todos los metadatos de los ranking de tu aplicación.

Recurso de REST: metagame

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

Recurso de REST: playerGameEvents

Métodos
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Registra un lote de eventos de juego del jugador para un jugador específico.

Recurso de REST: players

Métodos
get GET /games/v1/players/{playerId}
Recupera el recurso Player con el ID determinado.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Obtiene 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 del jugador con alcance para el usuario autenticado actualmente.
list GET /games/v1/players/me/players/{collection}
Obtén la colección de jugadores para el 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 para desarrolladores que estén 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 la principal del jugador de los PGS codificada 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 perfil).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Recupera todos los tokens de Recall asociados con el jugador de los PGS codificado en el ID de sesión de Recall proporcionado.
unlinkPersona POST /games/v1/recall:unlinkPersona
Borra un token de recuperación que vincula el principal del jugador de 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 para el jugador autenticado actualmente.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Enumera las puntuaciones en una tabla de clasificación, comenzando por la más alta.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Enumera las puntuaciones en una tabla de clasificación alrededor de la puntuación de un jugador (y la incluye).
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 para un ID de instantánea determinado.
list GET /games/v1/players/{playerId}/snapshots
Recupera una lista de las instantáneas creadas por tu aplicación para el jugador que corresponde al ID de jugador.

Recurso de REST: stats

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