Google Play Games Services API

Google Play 게임 서비스를 통해 개발자는 소셜 리더보드, 업적, 게임 상태, Google로 로그인 등의 기능을 사용하여 게임을 개선할 수 있습니다.

서비스: games.googleapis.com

이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API 요청을 실행할 때 다음 정보를 사용해야 합니다.

탐색 문서

탐색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참고할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 탐색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.

서비스 엔드포인트

서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기본 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.

  • https://games.googleapis.com

REST 리소스: accesstokens

메서드
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
첨부된 사용자 인증 정보로 식별되는 PGS 사용자의 Play Grouping API 토큰을 생성합니다.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
요청에 제공된 회수 세션 ID로 식별되는 PGS 사용자의 Play Grouping API 토큰을 생성합니다.

REST 리소스: achievementDefinitions

메서드
list GET /games/v1/achievements
애플리케이션의 모든 업적 정의를 나열합니다.

REST 리소스: achievements

메서드
increment POST /games/v1/achievements/{achievementId}/increment
현재 인증된 플레이어의 지정된 ID의 업적 단계를 증가시킵니다.
list GET /games/v1/players/{playerId}/achievements
현재 인증된 플레이어의 모든 애플리케이션 업적의 진행 상황을 나열합니다.
reveal POST /games/v1/achievements/{achievementId}/reveal
현재 인증된 플레이어에 대해 지정된 ID가 있는 업적의 상태를 REVEALED로 설정합니다.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
현재 인증된 플레이어가 업적을 잠금 해제하기 위해 진행한 단계를 설정합니다.
unlock POST /games/v1/achievements/{achievementId}/unlock
현재 인증된 플레이어의 이 업적을 잠금 해제합니다.
updateMultiple POST /games/v1/achievements/updateMultiple
현재 인증된 플레이어의 여러 업적을 업데이트합니다.

REST 리소스: applications

메서드
get GET /games/v1/applications/{applicationId}
지정된 ID가 있는 애플리케이션의 메타데이터를 가져옵니다.
getEndPoint POST /games/v1/applications/getEndPoint
요청된 도착지 유형의 URL을 반환합니다.
played POST /games/v1/applications/played
현재 인증된 사용자가 애플리케이션을 플레이하고 있음을 나타냅니다.
verify GET /games/v1/applications/{applicationId}/verify
이 요청과 함께 제공된 인증 토큰이 지정된 ID의 애플리케이션용인지 확인하고, 부여된 플레이어의 ID를 반환합니다.

REST 리소스: events

메서드
listByPlayer GET /games/v1/events
현재 인증된 사용자에 대해 이 애플리케이션의 이벤트에 대한 현재 진행 상황을 보여주는 목록을 반환합니다.
listDefinitions GET /games/v1/eventDefinitions
이 애플리케이션의 이벤트 정의 목록을 반환합니다.
record POST /games/v1/events
이 애플리케이션의 현재 인증된 사용자에 대해 이벤트가 발생한 횟수의 변경사항을 일괄적으로 기록합니다.

REST 리소스: leaderboards

메서드
get GET /games/v1/leaderboards/{leaderboardId}
지정된 ID가 있는 리더보드의 메타데이터를 가져옵니다.
list GET /games/v1/leaderboards
애플리케이션의 모든 리더보드 메타데이터를 나열합니다.

REST 리소스: metagame

메서드
getMetagameConfig GET /games/v1/metagameConfig
호출 애플리케이션의 메타게임 구성 데이터를 반환합니다.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
playerId에 해당하는 플레이어의 카테고리별로 집계된 플레이 데이터를 나열합니다.

REST 리소스: playerGameEvents

메서드
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
특정 플레이어의 플레이어 게임 이벤트 배치를 기록합니다.

REST 리소스: players

메서드
get GET /games/v1/players/{playerId}
지정된 ID의 플레이어 리소스를 가져옵니다.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
호출 애플리케이션과 동일한 개발자가 요청한 모든 게임에서 현재 인증된 플레이어의 애플리케이션 플레이어 ID를 가져옵니다.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
현재 인증된 사용자의 범위가 지정된 플레이어 식별자를 가져옵니다.
list GET /games/v1/players/me/players/{collection}
현재 인증된 사용자의 플레이어 컬렉션을 가져옵니다.

REST 리소스: recall

메서드
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
제공된 리콜 세션 ID에 인코딩된 PGS 플레이어와 연결된 요청된 모든 게임에서 리콜 토큰을 가져옵니다.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
제공된 리콜 세션 ID에 인코딩된 PGS 플레이어와 연결된 모든 개발자 게임에서 마지막 리콜 토큰을 가져옵니다.
linkPersona POST /games/v1/recall:linkPersona
제공된 회수 세션 ID에 인코딩된 PGS 플레이어 주 구성원을 인게임 계정과 연결
resetPersona POST /games/v1/recall:resetPersona
지정된 페르소나를 프로필이 있는 플레이어 또는 프로필이 없는 플레이어에 연결하는 모든 리콜 토큰을 삭제합니다.
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
제공된 리콜 세션 ID에 인코딩된 PGS 플레이어와 연결된 모든 리콜 토큰을 가져옵니다.
unlinkPersona POST /games/v1/recall:unlinkPersona
리콜 세션으로 식별되는 PGS 플레이어 주 구성원과 '페르소나' 또는 토큰 값으로 식별되는 인게임 계정을 연결하는 리콜 토큰을 삭제합니다.

REST 리소스: revisions

메서드
check GET /games/v1/revisions/check
게임 클라이언트가 최신 버전인지 확인합니다.

REST 리소스: scores

메서드
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
현재 인증된 플레이어의 리더보드에서 최고 점수와 선택적으로 순위를 가져옵니다.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
리더보드에서 상위부터 점수를 나열합니다.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
플레이어의 점수를 중심으로 (플레이어의 점수 포함) 리더보드의 점수를 나열합니다.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
지정된 순위표에 점수를 제출합니다.
submitMultiple POST /games/v1/leaderboards/scores
리더보드에 여러 점수를 제출합니다.

REST 리소스: snapshots

메서드
get GET /games/v1/snapshots/{snapshotId}
지정된 스냅샷 ID의 메타데이터를 가져옵니다.
list GET /games/v1/players/{playerId}/snapshots
플레이어 ID에 해당하는 플레이어를 위해 애플리케이션에서 만든 스냅샷 목록을 가져옵니다.

REST 리소스: stats

메서드
get GET /games/v1/stats
현재 인증된 사용자의 이 애플리케이션에서의 참여도 및 지출 통계를 반환합니다.