Com os serviços relacionados a jogos do Google Play, os desenvolvedores podem melhorar os jogos com placares sociais, conquistas, estado do jogo, login com o Google e muito mais.
- Recurso REST: accesstokens
- Recurso REST: achievementDefinitions
- Recurso REST: conquistas
- Recurso REST: applications
- Recurso REST: eventos
- Recurso REST: placares
- Recurso REST: metagame
- Recurso REST: players
- Recurso REST: recall
- Recurso REST: revisões
- Recurso REST: scores
- 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 de ambiente de desenvolvimento integrado 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 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. |
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. |
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. |
updateMultiple |
POST /games/v1/achievements/updateMultiple Atualiza vários conquistas para o jogador autenticado. |
Recurso REST: applications
| 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 ponto de extremidade solicitado. |
played |
POST /games/v1/applications/played Indica que o usuário autenticado está usando seu aplicativo. |
verify |
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 a que ele foi concedido. |
Recurso REST: events
| Métodos | |
|---|---|
listByPlayer |
GET /games/v1/events Retorna uma lista mostrando o progresso atual dos eventos no app para o usuário autenticado. |
listDefinitions |
GET /games/v1/eventDefinitions Retorna uma lista das definições de eventos neste app. |
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 do aplicativo. |
Recurso REST: leaderboards
| Métodos | |
|---|---|
get |
GET /games/v1/leaderboards/{leaderboardId} Recupera os metadados da tabela de classificação com o ID fornecido. |
list |
GET /games/v1/leaderboards Lista todos os metadados da tabela de classificação do seu aplicativo. |
Recurso REST: metagame
| Métodos | |
|---|---|
getMetagameConfig |
GET /games/v1/metagameConfig Retorna os dados de configuração do metagame 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 de jogador com o ID fornecido. |
getMultipleApplicationPlayerIds |
GET /games/v1/players/me/multipleApplicationPlayerIds Extrai os IDs de jogadores do aplicativo para o jogador autenticado em todos os jogos solicitados pelo mesmo desenvolvedor do aplicativo de chamada. |
getScopedPlayerIds |
GET /games/v1/players/me/scopedIds Recupera identificadores de jogadores com 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} Recupera 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} Recupera o último token de recuperação de todos os jogos do desenvolvedor associados ao player do PGS codificado no ID da sessão de recuperação fornecido. |
linkPersona |
POST /games/v1/recall:linkPersona Associa o principal do jogador do PGS codificado no ID da sessão de recuperação fornecido a uma conta no jogo |
resetPersona |
POST /games/v1/recall:resetPersona Exclua todos os tokens de recuperação que vinculam a persona a qualquer jogador (com ou sem perfil). |
retrieveTokens |
GET /games/v1/recall/tokens/{sessionId} Recupera todos os tokens de recuperação associados ao player do PGS codificado no ID da sessão de recuperação fornecido. |
unlinkPersona |
POST /games/v1/recall:unlinkPersona Exclua 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 pelo "perfil" ou pelo valor do token. |
Recurso REST: revisions
| Métodos | |
|---|---|
check |
GET /games/v1/revisions/check Verifica se o cliente do jogo está desatualizado. |
Recurso REST: scores
| Métodos | |
|---|---|
get |
GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan} Receba pontuações altas e, opcionalmente, classificações nos placares do jogador autenticado. |
list |
GET /games/v1/leaderboards/{leaderboardId}/scores/{collection} Lista as pontuações em uma tabela de classificação, começando pela parte de cima. |
listWindow |
GET /games/v1/leaderboards/{leaderboardId}/window/{collection} Lista as pontuações em um placar em torno (e incluindo) a pontuação de um jogador. |
submit |
POST /games/v1/leaderboards/{leaderboardId}/scores Envia uma pontuação para a tabela de classificação especificada. |
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 app 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 no app para o usuário autenticado. |