Google Play Game Services

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 리소스: 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
현재 인증된 사용자의 이 애플리케이션 참여도 및 지출 통계를 반환합니다.