O serviço relacionado a jogos do Google Play permite que os desenvolvedores aprimorem os jogos com placares sociais, conquistas, estado do jogo, login com o Google e muito mais.
- Recurso REST: accesstokens
- Recurso REST: conquistas" (em inglês)
- Recurso REST: conquistas
- Recurso REST: aplicativos
- Recurso REST: eventos
- Recurso REST: placares
- Recurso REST: metajogo
- Recurso REST: players
- Recurso REST: recall
- Recurso REST: revisões
- Recurso REST: pontuações
- Recurso REST: snapshots
- Recurso REST: estatísticas
Serviço: games.googleapis.com
Para chamar esse serviço, recomendamos que você use as bibliotecas de cliente fornecidas pelo Google. Caso seu aplicativo precise usar suas próprias bibliotecas 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 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 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 |
de POST /games/v1/accesstokens/generatePlayGroupingApiToken
Gera um token da API Play Grouping para o usuário dos Serviços relacionados a jogos do Google Play identificado pela credencial anexada. |
generateRecallPlayGroupingApiToken |
de 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 |
de GET /games/v1/achievements
Lista todas as definições de conquista para seu aplicativo. |
Recurso REST: conquistas
Métodos | |
---|---|
increment |
de POST /games/v1/achievements/{achievementId}/increment
Incrementa as etapas da conquista com o ID fornecido para o jogador autenticado no momento. |
list |
de GET /games/v1/players/{playerId}/achievements
Lista o progresso de todas as conquistas do seu aplicativo para o jogador autenticado no momento. |
reveal |
de POST /games/v1/achievements/{achievementId}/reveal
Define o estado da conquista com o ID fornecido como REVEALED para o jogador autenticado no momento. |
setStepsAtLeast |
de POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Define as etapas para o jogador autenticado no momento desbloquear uma conquista. |
unlock |
de POST /games/v1/achievements/{achievementId}/unlock
Desbloqueia esta conquista para o jogador autenticado no momento. |
updateMultiple |
de POST /games/v1/achievements/updateMultiple
Atualiza várias conquistas para o jogador autenticado no momento. |
Recurso REST: applications
Métodos | |
---|---|
get |
de GET /games/v1/applications/{applicationId}
Recupera os metadados do aplicativo com o ID fornecido. |
getEndPoint |
de POST /games/v1/applications/getEndPoint
Retorna um URL para o tipo de ponto de destino solicitado. |
played |
de POST /games/v1/applications/played
Indicar que o usuário autenticado no momento está reproduzindo seu aplicativo. |
verify |
de GET /games/v1/applications/{applicationId}/verify
Verifica se o token de autenticação fornecido com essa 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 |
de GET /games/v1/events
Retorna uma lista que mostra o progresso atual dos eventos deste aplicativo para o usuário autenticado no momento. |
listDefinitions |
de GET /games/v1/eventDefinitions
Retorna uma lista das definições de eventos neste aplicativo. |
record |
de POST /games/v1/events
Registra um lote de alterações no número de vezes que os eventos ocorreram para o usuário atualmente autenticado deste aplicativo. |
Recurso da REST: Leaderboards
Métodos | |
---|---|
get |
de GET /games/v1/leaderboards/{leaderboardId}
Recupera os metadados do placar com o ID fornecido. |
list |
de GET /games/v1/leaderboards
Lista todos os metadados de quadro de liderança para seu aplicativo. |
Recurso REST: metagame
Métodos | |
---|---|
getMetagameConfig |
de GET /games/v1/metagameConfig
Retorne os dados de configuração do metajogo para o aplicativo de chamada. |
listCategoriesByPlayer |
de GET /games/v1/players/{playerId}/categories/{collection}
Lista dados do jogo agregados por categoria para o jogador correspondente a playerId . |
Recurso REST: players
Métodos | |
---|---|
get |
de GET /games/v1/players/{playerId}
Recupera o recurso Player com o ID fornecido. |
getMultipleApplicationPlayerIds |
de 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 |
de GET /games/v1/players/me/scopedIds
Recupera identificadores de jogadores com escopo para o usuário autenticado no momento. |
list |
de GET /games/v1/players/me/players/{collection}
Recebe a coleção de jogadores do usuário autenticado no momento. |
Recurso REST: recall
Métodos | |
---|---|
gamesPlayerTokens |
de GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Extrair os tokens de recuperação de todos os jogos solicitados associados ao jogador dos Serviços relacionados a jogos do Google Play (PGS, na sigla em inglês) codificados no ID da sessão de recuperação fornecido. |
lastTokenFromAllDeveloperGames |
de GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Extrai o último token de recuperação de todos os jogos de desenvolvedores associados ao jogador do PGS codificado no ID da sessão de recuperação fornecido. |
linkPersona |
de POST /games/v1/recall:linkPersona
Associe o principal jogador do PGS codificado no ID da sessão de recuperação a uma conta no jogo |
resetPersona |
de POST /games/v1/recall:resetPersona
Exclua todos os tokens de Recall que vinculam o perfil especificado a qualquer jogador (com ou sem um perfil). |
retrieveTokens |
de GET /games/v1/recall/tokens/{sessionId}
Extrai todos os tokens de recuperação associados ao player dos serviços relacionados a jogos do Google Play (PGS, na sigla em inglês) codificados no ID da sessão de recuperação fornecido. |
unlinkPersona |
de POST /games/v1/recall:unlinkPersona
Excluir um token de recuperação que vincula a conta principal do jogador do PGS identificada pela sessão e uma conta no jogo identificada pela "persona". ou pelo valor do token. |
Recurso REST: revisions
Métodos | |
---|---|
check |
de GET /games/v1/revisions/check
Verifica se o cliente de jogos está desatualizado. |
Recurso REST: scores
Métodos | |
---|---|
get |
de GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Receba pontuações mais altas e, opcionalmente, classificações nos placares do jogador autenticado no momento. |
list |
de GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Lista as pontuações em um placar, começando da parte superior. |
listWindow |
de GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Lista as pontuações em um placar ao redor (e inclusive) da pontuação de um jogador. |
submit |
de POST /games/v1/leaderboards/{leaderboardId}/scores
Envia uma pontuação para o placar especificado. |
submitMultiple |
de POST /games/v1/leaderboards/scores
Envia várias pontuações para os placares. |
Recurso REST: snapshots
Métodos | |
---|---|
get |
de GET /games/v1/snapshots/{snapshotId}
Recupera os metadados de um determinado ID de snapshot. |
list |
de GET /games/v1/players/{playerId}/snapshots
Recupera uma lista de snapshots criados pelo aplicativo para o player correspondente ao ID do jogador. |
Recurso REST: stats
Métodos | |
---|---|
get |
de GET /games/v1/stats
Retorna estatísticas de engajamento e gastos neste aplicativo para o usuário autenticado no momento. |