--- title: "구글 연동" slug: "game-gamepot3-google-integration" tags: ["GAMEPOT 3.0"] updated: 2026-09-17T09:07:47Z published: 2026-09-17T09:07:47Z canonical: "guide.ncloud-docs.com/game-gamepot3-google-integration" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 구글 연동 Classic/VPC 환경에서 이용 가능합니다. 구글 로그인 기능을 사용하기 위한 콘솔 사용 가이드 입니다. 게임팟 연동 이외 콘솔 사용법은 다음을 참조해 주십시오. - [Play Console 도움말 센터](https://support.google.com/googleplay/android-developer/answer/9859152?sjid=17624558228702131677-AP) - Google Play Console: [https://play.google.com/console/](https://play.google.com/console/) - Google Cloud Platform: [https://console.cloud.google.com/?hl=ko](https://console.cloud.google.com/?hl=ko) - Firebase Console: [https://console.firebase.google.com/](https://console.firebase.google.com/) ## GAMEPOT 대시보드에 구글 로그인 인증 정보 등록 구글 로그인 인증 키를 GAMEPOT 대시보드에 등록하는 방법은 다음과 같습니다. GAMEPOT 대시보드 > **프로젝트 설정** > **인증** > **Google 메뉴**를 차례대로 클릭해 **'Client ID (Android, ios) / Client Secret'** 를 입력해 주십시오. ![gamepot-google-login03.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-google-login03.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) ## 구글 로그인 설정 구글 로그인을 사용하시려면 GAMEPOT 대시보드 > **프로젝트 설정** > **인증** > **Google**에서 총 3가지 항목에 대해 입력해 주십시오. ![gamepot-google-login00.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-google-login00.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) 1. Client ID (Android) 2. Client ID (iOS) 3. Client Secret ### Client ID / Client Secret 정보 확인 방법 #### 1) Firebase 콘솔 설정 1. Firebase 콘솔 > 프로젝트 선택 > 프로젝트 개요 옆의 '톱니바퀴' 아이콘 클릭 > **프로젝트 설정**을 클릭해 주십시오. ![gamepot-googleLogin01.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin01.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) 2. 하단의 내 앱 부분의 빌드에서 사용하는 SHA-1 값을 추가해 주십시오. ![gamepot-googleLogin02.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin02.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) 3. 구글 스토어 콘솔에서 앱 서명 기능을 사용중이라면, 앱 서명 키 인증서에 있는 SHA-1 값도 추가해 주십시오. - 구글 앱서명 확인: Google Play Console > 프로젝트 선택 > 설정 > 앱 서명 > 앱 서명 키 인증서 > SHA-1 인증서 지문 ![gamepot-googleLogin03.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin03.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) #### 2) Google Cloud Console - OAuth 동의 화면 구성 1. API 및 서비스 > OAuth 동의 화면으로 이동하여 User Type은 외부로 선택해 주세요. ![gamepot-googleLogin04.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin04.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) 2. 앱 이름, 사용자 지원 이메일, 개발자 연락처 정보를 입력해 주십시오. ![gamepot-googleLogin05.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin05.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) - 저장 후 **[계속]** 버튼을 클릭하여 OAuth 동의 화면 구성을 마칩니다. 3. 설정 완료 후, '게시 상태 = 프로덕션 단계 / 사용자 유형 = 외부'로 올바르게 설정되어 있는지 확인해 주십시오. ![gamepot-googleLogin06.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin06.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) #### 3) Google Cloud Console - 사용자 인증 정보 설정 1. API 및 서비스 > 사용자 인증 정보 > 사용자 인증정보 만들기 > OAuth 클라이언트 ID 를 차례대로 선택해 주세요. ![gamepot-googleLogin07.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin07.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) 2. 애플리케이션 유형은 빌드 플랫폼에 맞춰 생성해 주세요. - 구글 원탭 로그인 기능 사용을 위해서는 웹 애플리케이션은 필수로 생성해 주셔야 합니다. ![gamepot-googleLogin08.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin08.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) 1. 애플리케이션 유형에 따른 필수 정보를 입력해 주세요. - Android는 패키지명 입력 시 빌드 때 사용했던 **패키지명**과 빌드하는 앱의 **SHA-1 값**을 입력해주세요 ![gamepot-google-login01.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-google-login01.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) - iOS는 **번들 ID**를 입력해주세요 ![gamepot-googleLogin10.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin10.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) - 웹 앱플리에이션은 이름 수정외에 따로 입력하실 부분은 없습니다. ![gamepot-googleLogin11.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin11.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) #### 4) Google 로그인을 위한 게임팟 대시보드의 입력 값 정보 ![gamepot-googleLogin13.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin13.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) 1. 위에서 생성한 iOS 클라이언트 ID 선택 → 클라이언트 ID 값 복사 → GAMEPOT 대시보드 > 프로젝트 설정 > 인증 > Google의 **Client ID (iOS)** 에 입력 2. 위에서 생성한 웹 애플리케이션 클라이언트 ID 선택 → **클라이언트 ID, 클라이언트 보안 비밀번호** 값 복사 → GAMEPOT 대시보드 > 프로젝트 설정 > 인증 > Google의 **Client ID (Android)** / **Client Secret** 에 입력 (상단에 프로젝트를 꼭 확인해 주세요) ### iOS Native URL Schemes 입력 ios에서 구글 로그인 연동을 하시려면 아래 방법과 같이 iOS URL Schemes 값을 Info > URL Types 에 입력해야 합니다. ![gamepot-google-xcode-url.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-google-xcode-url%281%29.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) ### Unity URL Schemes 입력 (iOS) 유니티의 경우 ios에서 구글 로그인 연동을 하시려면 아래 방법과 같이 Schemes 값을 Supported URL Schemes에 입력해야 합니다. Player Settings -> Other Settings -> **Supported URL Schemes** 에 구글에서 발급된 iOS URL 스키마를 그림과 같이 입력해 주세요. - size에 '1'을 입력하면 Element 0 칸이 생겨 입력할 수 있습니다. ![gamepot-googleLogin15.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-googleLogin15.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) #### iOS URL Schemes 값 확인 방법 - Google Cloud Console > 사용자 인증 정보 > iOS 클라이언트 ID > iOS URL 스키마 ![gamepot-google-login02png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/gamepot-google-login02.png?sv=2026-02-06&spr=https&st=2026-11-14T06%3A18%3A34Z&se=2026-11-14T07%3A18%3A34Z&sr=c&sp=r&sig=KRjsoULc1DXlEmI22jqhOqiOItgtd3BkvADWk5CxLwk%3D) #### 로그인 오류 코드 정의 | Code | Message | Text | | --- | --- | --- | | 7003 | Couldn't get credential from result. (10: [28444] Developer console is not set up correctly. | 구글 로그인에 필요한 개발자 콘솔 설정이 올바르지 않아 발생하는 경우로 Client_ID 확인 필요 |