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 리소스: 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

방법
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 리소스: 버전

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