Google Play Games Services API

Com o serviço Google Play Games, os desenvolvedores podem melhorar os jogos com placares sociais, conquistas, estado do jogo, login com o Google e muito mais.

Serviço: games.googleapis.com

Para chamar esse serviço, recomendamos que você use as bibliotecas de cliente fornecidas pelo Google. Caso o aplicativo precise usar bibliotecas próprias para chamar esse serviço, use as informações a seguir quando fizer as solicitações da API.

Documento de descoberta

Um Documento de descoberta é uma especificação legível por máquina para descrever e consumir APIs REST. Ele é usado para criar bibliotecas de cliente, plug-ins de IDE e outras ferramentas que interagem com as APIs do Google. Um serviço pode fornecer vários documentos de descoberta. O serviço fornece o seguinte documento de descoberta:

Endpoint de serviço

Um endpoint de serviço é um URL de base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários endpoints de serviço. Este serviço tem o endpoint a seguir, e todos os URIs abaixo são relativos a ele:

  • https://games.googleapis.com

Recurso REST: accesstokens

Métodos
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Gera um token da API Play Grouping para o usuário do PGS identificado pela credencial anexada.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Gera um token da API Play Grouping para o usuário do PGS identificado pelo ID da sessão de recuperação fornecido na solicitação.

Recurso REST: achievementDefinitions

Métodos
list GET /games/v1/achievements
Lista todas as definições de conquistas do seu aplicativo.

Recurso REST: conquistas

Métodos
increment POST /games/v1/achievements/{achievementId}/increment
Incrementa as etapas da conquista com o ID especificado para o jogador autenticado no momento.
list GET /games/v1/players/{playerId}/achievements
Lista o progresso de todas as conquistas do aplicativo para o jogador autenticado no momento.
reveal POST /games/v1/achievements/{achievementId}/reveal
Define o estado da conquista com o ID especificado como REVEALED para o jogador autenticado no momento.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Define as etapas para o jogador autenticado desbloquear uma conquista.
unlock POST /games/v1/achievements/{achievementId}/unlock
Desbloqueia essa conquista para o jogador autenticado no momento.
updateMultiple POST /games/v1/achievements/updateMultiple
Atualiza várias conquistas para o jogador autenticado.

Recurso REST: applications

Métodos
get GET /games/v1/applications/{applicationId}
Recupera os metadados do aplicativo com o ID especificado.
getEndPoint POST /games/v1/applications/getEndPoint
Retorna um URL para o tipo de destino solicitado.
played POST /games/v1/applications/played
Indica que o usuário autenticado no momento está jogando seu aplicativo.
verify GET /games/v1/applications/{applicationId}/verify
Verifica se o token de autenticação fornecido com esta solicitação é para o aplicativo com o ID especificado e retorna o ID do jogador para quem ele foi concedido.

Recurso REST: events

Métodos
listByPlayer GET /games/v1/events
Retorna uma lista mostrando o progresso atual dos eventos neste aplicativo para o usuário autenticado no momento.
listDefinitions GET /games/v1/eventDefinitions
Retorna uma lista das definições de eventos neste aplicativo.
record POST /games/v1/events
Registra um lote de mudanças no número de vezes que os eventos ocorreram para o usuário autenticado no momento deste aplicativo.

Recurso REST: leaderboards

Métodos
get GET /games/v1/leaderboards/{leaderboardId}
Recupera os metadados do ranking com o ID especificado.
list GET /games/v1/leaderboards
Lista todos os metadados do ranking do seu aplicativo.

Recurso REST: metagame

Métodos
getMetagameConfig GET /games/v1/metagameConfig
Retorna os dados de configuração do metajogo para o aplicativo de chamada.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Lista os dados de jogo agregados por categoria para o jogador correspondente a playerId.

Recurso REST: playerGameEvents

Métodos
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Registra um lote de eventos de jogo de um jogador específico.

Recurso REST: players

Métodos
get GET /games/v1/players/{playerId}
Recupera o recurso Player com o ID especificado.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Recebe os IDs de jogador do aplicativo para o jogador autenticado no momento em todos os jogos solicitados pelo mesmo desenvolvedor do aplicativo de chamada.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Recupera identificadores de jogador no escopo para o usuário autenticado no momento.
list GET /games/v1/players/me/players/{collection}
Receba a coleção de jogadores do usuário autenticado no momento.

Recurso REST: recall

Métodos
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Recupere os tokens de recuperação de todos os jogos solicitados associados ao jogador do PGS codificado no ID da sessão de recuperação fornecido.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Recupere o último token de recuperação de todos os jogos do desenvolvedor associados ao jogador do PGS codificado no ID da sessão de recuperação fornecido.
linkPersona POST /games/v1/recall:linkPersona
Associe o principal do jogador do PGS codificado no ID da sessão de recall fornecido a uma conta no jogo.
resetPersona POST /games/v1/recall:resetPersona
Exclua todos os tokens de recall que vinculam a persona especificada a qualquer jogador (com ou sem perfil).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Recupere todos os tokens de recuperação associados ao jogador do PGS codificado no ID da sessão de recuperação fornecido.
unlinkPersona POST /games/v1/recall:unlinkPersona
Exclui um token de recuperação que vincula o principal do jogador do PGS identificado pela sessão de recuperação e uma conta no jogo identificada pela "persona" ou pelo valor do token.

Recurso REST: revisions

Métodos
check GET /games/v1/revisions/check
Verifica se o cliente de jogos está desatualizado.

Recurso REST: scores

Métodos
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Receba as maiores pontuações e, opcionalmente, as classificações nos placares para o jogador autenticado.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Lista as pontuações em um placar, começando de cima.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Lista as pontuações em um ranking ao redor (e incluindo) a pontuação de um jogador.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Envia uma pontuação para o ranking especificado.
submitMultiple POST /games/v1/leaderboards/scores
Envia várias pontuações para os placares.

Recurso REST: snapshots

Métodos
get GET /games/v1/snapshots/{snapshotId}
Recupera os metadados de um determinado ID de snapshot.
list GET /games/v1/players/{playerId}/snapshots
Recupera uma lista de snapshots criados pelo aplicativo para o jogador correspondente ao ID do jogador.

Recurso REST: stats

Métodos
get GET /games/v1/stats
Retorna estatísticas de engajamento e gastos neste aplicativo para o usuário autenticado no momento.