Google Play Game Services

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 procesable para describir y consumir las API 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 extremo de servicio es una URL base que especifica la dirección de la red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a é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 recuperación proporcionado en la solicitud.

Recurso de REST: achievementDefinitions

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

Recurso de REST: logros

Métodos
increment POST /games/v1/achievements/{achievementId}/increment
Aumenta los pasos del logro con el ID proporcionado para el jugador autenticado actualmente.
list GET /games/v1/players/{playerId}/achievements
Enumera el progreso de todos los logros de la 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 para el 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á reproduciendo 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 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 de la tabla de clasificación con el ID determinado.
list GET /games/v1/leaderboards
Muestra una lista de todos los metadatos de la tabla de clasificación de tu aplicación.

Recurso de REST: metagame

Métodos
getMetagameConfig GET /games/v1/metagameConfig
Devuelve los datos de configuración de metajuego de 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: players

Métodos
get GET /games/v1/players/{playerId}
Recupera el recurso Reproductor con el ID determinado.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Obtén los ID de jugador de la aplicación para el jugador autenticado actualmente en todos los juegos solicitados por el mismo desarrollador de la aplicación que realiza la llamada.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Recupera identificadores de jugador con alcance 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 Recall de todos los juegos solicitados asociados con el reproductor de los PGS codificados 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 de desarrollador asociados con el reproductor de los PGS codificado en el ID de sesión de recuperación proporcionado.
linkPersona POST /games/v1/recall:linkPersona
Asocia la principal del reproductor 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 vinculen a un arquetipo determinado con un jugador (con o sin un perfil).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Recupera todos los tokens de Recall asociados con el reproductor de los PGS codificados en el ID de sesión de recuperación proporcionado.
unlinkPersona POST /games/v1/recall:unlinkPersona
Borrar un token de recuperación que vincule el principal del jugador de los PGS identificado por la sesión de recuperación y una cuenta en el juego identificada por la "persona" o por el valor del token.

Recurso de REST: revisions

Métodos
check GET /games/v1/revisions/check
Comprueba 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, opcionalmente, clasificaciones en las tablas de clasificación del jugador autenticado actualmente.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Enumera las puntuaciones en una tabla de clasificación, empezando por la parte superior.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Muestra las puntuaciones en una tabla de clasificación en torno a la puntuación del jugador (incluida).
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 creadas por tu aplicación para el reproductor 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.