Google Cloud에서 직접 Play 게임즈 서비스 프로젝트를 보고 수정하려는 경우가 있을 수 있습니다.
일반적인 시나리오는 다음과 같습니다.
- 프로젝트에서 추가 API를 사용하도록 설정(예: Google Drive).
- OAuth 2.0 대화상자에서 게임의 브랜드 정보 수정.
- API 할당량 확인 및 추가 요청(필요한 경우).
- 이전에 만든 클라이언트 ID에서 승인된 URI 또는 자바스크립트 출처 수정.
내 프로젝트 보기
Google Cloud에서 프로젝트를 보려면 다음 단계를 따르세요.
- 구성 페이지에서 게임의 사용자 인증 정보를 선택합니다(사용자 늘리기 > Play 게임즈 서비스 > 설정 및 관리 > 구성).
- 인증 섹션으로 이동하여 Google Cloud에서 보기를 클릭합니다.
API 사용 할당량 조정
Google Cloud에서 게임에 설정된 API 사용량 한도와 사용된 할당량을 확인할 수 있습니다. 악용 사용자 (또는 버그가 있는 게임 클라이언트)가 할당량을 소진하지 못하도록 사용자별 한도를 설정할 수도 있습니다.
프로젝트의 사용량 한도를 확인 또는 변경하거나 할당량 증가를 요청하려면 다음 단계를 따르세요.
- 프로젝트의 결제 계정이 아직 없는 경우 계정을 만듭니다.
- API 콘솔에서 API 라이브러리의 사용 설정된 API 페이지를 방문하여 목록에서 API를 선택합니다.
- 할당량 관련 설정을 확인하고 변경하려면 할당량을 선택합니다. 사용 통계를 확인하려면 사용량을 선택합니다.
'사용자'는 할당량을 요청하는 클라이언트의 IP 주소를 기준으로 확인됩니다. 예를 들어 모든 요청이 단일 서버에서 온 경우 그 서버는 단일 스팸 사용자로 잘못 태그될 수 있습니다. 이를 방지하려면 API 엔드포인트 요청에 userIp=x.x.x.x 인수를 추가하면 됩니다.
사용자별 할당량 설정에 대해 자세히 알아보려면 API 사용량 상한 설정을 참고하세요.
사용자별 한도 외에도 Google Play 게임즈 서비스 API에는 애플리케이션 차원의 일일 한도도 있습니다. 일반적으로는 사전 할당된 한도를 변경할 필요가 없습니다. 하지만 예정된 출시 이벤트 등으로 사용량이 급증할 것으로 예상되면 추가 요청 링크를 클릭하여 추가 할당량을 요청할 수 있습니다.
기타 API 활성화
Play Console에서 클라이언트 ID를 만들면 Google Play 게임즈 서비스 API가 프로젝트에 자동으로 사용 설정됩니다. Google Cloud에서 다른 Google API를 활성화할 수 있습니다.
프로젝트에 API를 사용 설정하려면 다음 단계를 따르세요.
Google API 콘솔에서 API 라이브러리를 엽니다. 메시지가 표시되면 프로젝트를 선택하거나 새로운 프로젝트를 만듭니다. API 라이브러리에는 사용 가능한 모든 API가 제품군과 인기도를 기준으로 분류되어 있습니다.
사용 설정하려는 API가 목록에 없는 경우 검색을 사용하여 찾습니다.
사용 설정하려는 API를 선택한 다음 사용 설정 버튼을 클릭합니다.
메시지가 표시되면 결제를 사용 설정합니다.
메시지가 표시되면 API의 서비스 약관에 동의합니다.
브랜드 정보 수정
OAuth 2.0 대화상자에 표시되는 게임의 브랜드 정보 (제목, 로고 등)를 수정하려면 Google Cloud의 동의 화면에서 속성을 설정합니다.
프로젝트의 동의 화면을 설정하려면 다음 단계를 따르세요.
- Play Console에서 동의 화면 페이지를 엽니다. 메시지가 표시되면 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
- 양식을 작성하고 저장을 클릭합니다.
OAuth 사용자 유형 수정
프로덕션 (테스트 및 출시 > 프로덕션) 테스트 트랙에서 개인 테스트 계정을 사용하여 테스트하는 경우 Google Cloud에서 OAuth 대상 설정을 External로 구성해야 합니다. 자세한 내용은 앱 잠재고객 관리를 참고하세요.
클라이언트 ID 관련 속성 수정
OAuth 2.0 클라이언트 ID와 관련된 속성 (웹 출처, 웹 앱의 리디렉션 URL 등)을 수정하려면 다음 단계를 따르세요.
- Play Console을 열고 게임으로 이동합니다.
- 구성 페이지에서 게임의 사용자 인증 정보를 선택합니다(사용자 늘리기 > Play 게임즈 서비스 > 설정 및 관리 > 구성).
- 인증 섹션 하단으로 스크롤한 다음 Google Cloud에서 보기를 클릭합니다.
- Google Cloud에서 프로젝트를 선택합니다.
- 왼쪽 사이드바에서 API 및 인증을 선택합니다. 표시된 API 목록에 Google Play 게임즈 서비스 API 상태가 사용으로 설정되어 있는지 확인합니다.
- 왼쪽 사이드바에서 등록된 앱을 선택합니다.
- OAuth 2.0 클라이언트 ID 섹션을 펼쳐 수정할 속성을 찾습니다.
기존 Cloud 프로젝트에서 OAuth 클라이언트 마이그레이션
Google Cloud에서 프로젝트를 보려면 프로젝트 보기의 단계를 따르세요.
Play 게임즈 서비스 (PGS)를 설정하려면 고유한 Google Cloud 프로젝트가 필요합니다. 여러 게임이 하나의 Cloud 프로젝트를 공유하는 경우 올바른 구성을 위해 Android OAuth 클라이언트를 독립적인 프로젝트로 이전해야 합니다.
위 예시에서 게임 1과 게임 2는 Google 로그인을 위해 단일 Google Cloud 프로젝트 내에 웹 및 Android 클라이언트를 만들었습니다. Game 2의 웹 및 Android 클라이언트를 현재 기존 Google Cloud 프로젝트에서 새 타겟 Google Cloud 프로젝트로 이동해야 합니다.
1단계: 백엔드 준비
전환을 수행하기 전에 이전 웹 클라이언트 ID와 새 웹 클라이언트 ID가 동시에 존재하도록 백엔드와 클라이언트를 조정해야 합니다.
- 서버 측 구성: 서버가 ID 토큰 내에서 웹 클라이언트 ID를 검증하는 경우 레거시 Cloud 프로젝트의 기존 클라이언트와 타겟 Cloud 프로젝트에서 생성해야 하는 새 클라이언트에서 발급한 ID 토큰을 동시에 지원하도록 서버 측 로직을 업데이트해야 합니다.
- 클라이언트 측 구성: 전환 시 새 웹 클라이언트 ID를 사용하여 로그인하려면 클라이언트 애플리케이션이 여러 웹 클라이언트 ID를 지원해야 합니다. 다음 방법 중 하나를 사용할 수 있습니다.
- 클라이언트 앱에 2개의 웹 클라이언트 ID가 내장되어 있으며, 이전 클라이언트 ID가 만료되면 새 웹 클라이언트 ID로 전환됩니다.
- 서버에서 최신 웹 클라이언트 ID를 동적으로 가져와 전환을 완료합니다.
- 웹 클라이언트 사전 생성: 원자적 전환 중에 발생할 수 있는 지연을 방지하려면 타겟 프로젝트에서 새 웹 클라이언트를 미리 만들어야 합니다.
2단계: 올바른 Google Cloud에서 새 웹 및 Android OAuth 클라이언트 구성
2.1단계: 타겟 Google Cloud 프로젝트에서 게임 2의 새 웹 OAuth 클라이언트를 만듭니다.
2.2단계: 경고: Android 클라이언트를 수정하면 게임 사용자가 Google로 로그인을 사용하여 게임에 로그인할 수 없으므로 2.2단계 후 즉시 2.3단계를 실행해야 합니다. 수정과 재생성 사이의 시간 간격을 최소화하려면 작업을 위해 웹페이지 2개를 동시에 여는 것이 좋습니다.
레거시 Google Cloud 프로젝트에서 게임 2의 Android 클라이언트 패키지 이름을 com.noexist.none와 같은 잘못된 값으로 변경합니다.
2.3단계: 타겟 Google Cloud 프로젝트에서 게임 2의 SHA-1 디지털 지문과 패키지 이름이 동일한 게임 2용 새 Android 클라이언트를 즉시 만듭니다.
3단계: 실시간 구성 배포
타겟 프로젝트에서 새 Android 클라이언트를 만든 후 즉시 다음을 실행합니다.
- 클라이언트 리디렉션: 동적 구성 메커니즘 (예: 원격 구성)을 사용하여 새 웹 클라이언트 ID를 사용하도록 클라이언트 애플리케이션을 즉시 전환합니다.
- 이전 클라이언트 유지: 문제가 발생할 경우 이전 OAuth 클라이언트 로그인으로 롤백할 수 있는 대체 옵션으로 이전 OAuth 클라이언트를 유지합니다.