Google Play Game Services

O serviço relacionado a jogos do Google Play permite que os desenvolvedores aprimorem jogos com placares sociais, conquistas, estado do jogo, login no 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. Se seu aplicativo precisar usar suas próprias bibliotecas para chamar esse serviço, use as informações a seguir ao fazer as solicitações de 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 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 detecção:

Endpoint de serviço

Um endpoint de serviço é um URL 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: achievementDefinition

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

Recurso REST: achievements

Métodos
increment POST /games/v1/achievements/{achievementId}/increment
Incrementa as etapas da conquista com o ID fornecido para o jogador autenticado no momento.
list GET /games/v1/players/{playerId}/achievements
Lista o progresso de todas as conquistas do app para o jogador autenticado no momento.
reveal POST /games/v1/achievements/{achievementId}/reveal
Define o estado da conquista com o ID fornecido como REVEALED para o jogador autenticado no momento.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Define as etapas para o jogador autenticado no momento para 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 no momento.

Recurso REST: Aplicativos

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

Recurso REST: events

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

Recurso REST: placares

Métodos
get GET /games/v1/leaderboards/{leaderboardId}
Recupera os metadados do placar com o ID fornecido.
list GET /games/v1/leaderboards
Lista todos os metadados do placar 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 reprodução agregados por categoria para o jogador correspondente a playerId.

Recurso REST: players

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

Recurso REST: recall

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

Recurso REST: revisões

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 maiores pontuações e, opcionalmente, classificações nos placares para o jogador autenticado no momento.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Lista as pontuações em um placar, começando pela parte superior.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Lista as pontuações em um placar em torno da pontuação de um jogador, inclusive.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Envia uma pontuação para o placar 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 seu 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.