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