Com o serviço relacionado a jogos do Google Play, os desenvolvedores podem aprimorar jogos com placares de redes sociais, conquistas, estado do jogo, login no Google e muito mais.
- Recurso REST: AchievementDefinições
- Recurso REST: conquistas
- Recurso REST: aplicativos
- Recurso REST: eventos
- Recurso REST: placares
- Recurso REST: metajogo
- Recurso REST: jogadores
- Recurso REST: recall
- Recurso REST: revisões (link em inglês)
- 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 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: achievementDefinitions
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 Aumenta o número de passos 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 seu 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 do jogador autenticado 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 do jogador autenticado no momento. |
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 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 essa solicitação é do 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 neste aplicativo. |
record |
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 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 do aplicativo que fez a chamada. |
listCategoriesByPlayer |
GET /games/v1/players/{playerId}/categories/{collection} Lista 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} Extrai o conjunto de jogadores do usuário autenticado no momento. |
Recurso REST: recall
Métodos | |
---|---|
linkPersona |
POST /games/v1/recall:linkPersona Associe 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 um perfil). |
retrieveTokens |
GET /games/v1/recall/tokens/{sessionId} Extraia todos os tokens de recall associados ao principal do jogador do PGS codificado no ID da sessão de recuperação fornecido. |
unlinkPersona |
POST /games/v1/recall:unlinkPersona Exclua um token de recuperação vinculando 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 pontuações maiores e, se quiser, classificações, nos placares do jogador autenticado no momento. |
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 placar relacionadas à pontuação de um jogador, incluindo a pontuação. |
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. |
Recurso REST: stats
Métodos | |
---|---|
get |
GET /games/v1/stats Retorna estatísticas de engajamento e gasto neste aplicativo para o usuário autenticado no momento. |