구글 (`google`)

🔔 최신화 일자: 2025-06-20

개요

google 네임스페이스는 구글 네이티브 로그인 기능을 제공하며, 사용자는 Google 계정을 통해 인증할 수 있습니다.

이 네임스페이스를 사용하여 로그인, 사용자 정보 조회, 로그인 상태 확인, 로그아웃과 같은 기능을 수행할 수 있습니다.

필수 선행 작업

nachocode SDK로 구글 네이티브 기능을 사용하기 위해서는 아래 사항이 먼저 완료되어야 합니다.

1. nachocode 대시보드의 [ 앱 설정 > 개발자 설정 > 안드로이드 네이티브 설정 ]에서 SHA-1 디지털 지문 확인

nachocode_developer_android_sha

정보

지문키를 확인하기 위해서는 안드로이드 빌드가 선행되어야 합니다.

2. Firebase 대시보드의 [ 프로젝트 > Authentication > 로그인 방법 ]에서 추가 제공 업체로 [ Google ] 선택 후 사용설정

firebase_authentication_login_methods

3. `GoogleService-Info.plist` 를 다운받은 후에 [ 프로젝트 설정 ] 클릭

firebase_authentication_login_methods_complete

4. `google-services.json` 파일 다운로드

firebase_download_google_services

5. [ Android 앱 ] 탭에서 [ 디지털 지문 추가 ] 클릭

firebase_android_add_fingerprint

6. 나쵸코드 대시보드에서 복사한 [ SHA-1 디지털 지문 ]을 입력 후 저장

firebase_android_save_fingerprint

7. nachocode 대시보드의 [ 앱 기능 > 푸시 알림 > 앱 푸시 설정 ]에 다운받은 파일(`GoogleService-Info.plist`, `google-services.json`)을 업로드

nachocode_google_push_notification_setting

경고

이미 푸시 설정이 되어있더라도 최신 구성 파일을 업로드해야 합니다.

8. nachocode 대시보드의 [ 앱 설정 > 개발자 설정 > 구글 네이티브 설정 ]에서 [ 구글 로그인 ] 토글을 활성화하여 앱 설정 완료

nachocode_developer_google_login

9. nachocode 대시보드의 [ 앱 빌드 > 안드로이드 앱 빌드 ]에서 [ 새 버전 만들기 ] 버튼을 클릭하여 빌드

nachocode_build_android_new_version

경고

구글 관련 네이티브 기능은 새로 빌드 된 버전의 앱부터 적용됩니다.

10. 빌드된 aab 파일을 Google Play Console에 업로드 후 [ 테스트 및 출시 > 설정 > 앱 서명 ]에서 앱 서명키 인증서의 [ SHA-1 인증서 지문 ]을 확인

google_console_fingerprint

경고

운영환경에서 구글 로그인을 사용하기 위한 필수 작업이므로 안드로이드 앱 출시 전 확인해주세요.

11. [ Google Play Console ]에서 복사한 [ SHA-1 디지털 지문 ]을 입력 후 저장

firebase_android_save_fingerprint

타입 정의

`GoogleResult`

구글 로그인 및 요청의 결과 상태를 나타내는 타입입니다.

export declare type GoogleSuccessResult = {
  status: 'success';
  statusCode: 200;
};

export declare type GoogleErrorResult = {
  status: 'error';
  statusCode: number;
  message: string;
};

export declare type GoogleResult = GoogleSuccessResult | GoogleErrorResult;

필드	타입	설명
`status`	`'error' \| 'success'`	요청 성공 또는 실패 상태
`statusCode`	`number`	상태 코드 (성공 시 200)
`message`	`string` (optional)	오류 메시지 (실패 시 반환)

`GoogleUserData`

구글 사용자 데이터를 나타내는 타입입니다.

export declare type GoogleUserData = {
  uid: string;
  email?: string;
  displayName?: string;
  photoURL?: string;
  phoneNumber?: string;
  isEmailVerified: boolean;
  providerId?: string;
};

필드	타입	설명
`uid`	`string`	사용자 고유 식별자
`email`	`string`	이메일 주소 (optional)
`displayName`	`string`	사용자 이름 (optional)
`photoURL`	`string`	프로필 사진 URL (optional)
`phoneNumber`	`string`	전화번호 (optional)
`isEmailVerified`	`boolean`	이메일 인증 여부
`providerId`	`string`	인증 제공자 ID (optional)

메서드 목록

메서드	설명	추가된 버전
`login(callback)`	구글 네이티브 로그인	ver.1.5.0
`isLoggedIn(callback)`	로그인 상태 확인	ver.1.5.0
`getUserData(callback)`	사용자 데이터 요청	ver.1.5.0
`logout(callback)`	구글 네이티브 로그아웃	ver.1.5.0

메서드 상세

since ver.1.5.0

주의

필수 선행 작업이 완료되어야 사용할 수 있습니다.

구글 네이티브 로그인 요청을 수행합니다.
로그인 성공 시 idToken 과 userData 를 콜백으로 반환합니다.

이름	타입	필수 여부	설명
`callback`	`(result: GoogleResult, idToken?: string, userData?: GoogleUserData) => void`	✅	로그인 결과를 반환하는 함수

해당 메서드는 반환 값을 가지지 않으며, 결과는 callback을 통해 비동기적으로 제공됩니다.

Nachocode.google.login((result, idToken, userData) => {
  if (result.status === 'success') {
    console.log('구글 로그인 성공', idToken, userData);
  } else {
    console.error('구글 로그인 실패', result.message);
  }
});

`isLoggedIn(callback: (result: GoogleResult, isLoggedIn: boolean, idToken?: string) => void): void`

since ver.1.5.0

주의

필수 선행 작업이 완료되어야 사용할 수 있습니다.

설명

현재 사용자가 구글 네이티브 로그인 상태인지 확인합니다.
로그인 여부(isLoggedIn)와 함께 idToken을 반환합니다.

로그인이 되어있을 경우 isLoggedIn에는 true 값이, idToken에는 문자열이 담겨 콜백을 호출합니다.
비로그인 상태거나 에러가 발생할 경우 isLoggedIn에는 false 값이, idToken은 undefined로 콜백을 호출합니다.

매개변수

이름	타입	필수 여부	설명
`callback`	`(result: GoogleResult, isLoggedIn: boolean, idToken?: string) => void`	✅	로그인 상태를 반환하는 함수

반환 값

해당 메서드는 반환 값을 가지지 않으며, 결과는 callback을 통해 비동기적으로 제공됩니다.

사용 예제

Nachocode.google.isLoggedIn((result, isLoggedIn, idToken) => {
  if (result.status === 'success') {
    if (isLoggedIn) {
      // 네이티브 구글 로그인된 상태
      console.log('구글 로그인 상태입니다.', idToken);
    } else {
      // 네이티브 구글 로그아웃 상태
      console.log('구글 로그인이 되어 있지 않습니다.');
    }
  } else {
    // 네이티브 정보 불러오기 실패
    console.error('구글 로그인 정보 불러오기 실패');
  }
});

`getUserData(callback: (result: GoogleResult, userData?: GoogleUserData) => void): void`

since ver.1.5.0

주의

필수 선행 작업이 완료되어야 사용할 수 있습니다.

설명

구글에서 사용자 데이터를 요청합니다.
로그인된 사용자의 프로필 정보를 가져올 수 있습니다.

매개변수

이름	타입	필수 여부	설명
`callback`	`(result: GoogleResult, userData?: GoogleUserData) => void`	✅	사용자 데이터를 반환하는 함수

반환 값

해당 메서드는 반환 값을 가지지 않으며, 결과는 callback을 통해 비동기적으로 제공됩니다.

사용 예제

Nachocode.google.getUserData((result, userData) => {
  if (result.status === 'success') {
    console.log('사용자 데이터:', userData);
  } else {
    console.error('사용자 데이터 요청 실패:', result.message);
  }
});

`logout(callback: (result: GoogleResult) => void): void`

since ver.1.5.0

주의

필수 선행 작업이 완료되어야 사용할 수 있습니다.

설명

구글 네이티브 로그인 세션을 로그아웃합니다.

매개변수

이름	타입	필수 여부	설명
`callback`	`(result: GoogleResult) => void`	✅	로그아웃 결과 콜백

반환 값

해당 메서드는 반환 값을 가지지 않으며, 결과는 callback을 통해 비동기적으로 제공됩니다.

사용 예제

Nachocode.google.logout(result => {
  if (result.status === 'success') {
    console.log('구글 로그아웃 완료');
  } else {
    console.error('구글 로그아웃 실패:', result.message);
  }
});

추가 정보

Google 로그인은 Firebase 인증 기반으로 동작하며, idToken은 서버 인증에 활용할 수 있습니다.
로그아웃 후에는 isLoggedIn() 호출 시 false가 반환됩니다.

개요​

필수 선행 작업​

1. nachocode 대시보드의 [ 앱 설정 > 개발자 설정 > 안드로이드 네이티브 설정 ]에서 SHA-1 디지털 지문 확인​

2. Firebase 대시보드의 [ 프로젝트 > Authentication > 로그인 방법 ]에서 추가 제공 업체로 [ Google ] 선택 후 사용설정​

3. GoogleService-Info.plist 를 다운받은 후에 [ 프로젝트 설정 ] 클릭​

4. google-services.json 파일 다운로드​

5. [ Android 앱 ] 탭에서 [ 디지털 지문 추가 ] 클릭​

6. 나쵸코드 대시보드에서 복사한 [ SHA-1 디지털 지문 ]을 입력 후 저장​

7. nachocode 대시보드의 [ 앱 기능 > 푸시 알림 > 앱 푸시 설정 ]에 다운받은 파일(GoogleService-Info.plist, google-services.json)을 업로드​

8. nachocode 대시보드의 [ 앱 설정 > 개발자 설정 > 구글 네이티브 설정 ]에서 [ 구글 로그인 ] 토글을 활성화하여 앱 설정 완료​

9. nachocode 대시보드의 [ 앱 빌드 > 안드로이드 앱 빌드 ]에서 [ 새 버전 만들기 ] 버튼을 클릭하여 빌드​

10. 빌드된 aab 파일을 Google Play Console에 업로드 후 [ 테스트 및 출시 > 설정 > 앱 서명 ]에서 앱 서명키 인증서의 [ SHA-1 인증서 지문 ]을 확인​

11. [ Google Play Console ]에서 복사한 [ SHA-1 디지털 지문 ]을 입력 후 저장​

타입 정의​

GoogleResult​

GoogleUserData​

메서드 목록​

메서드 상세​

login(callback: (result: GoogleResult, idToken?: string, userData?: GoogleUserData) => void): void​

설명​

매개변수​

반환 값​

사용 예제​

isLoggedIn(callback: (result: GoogleResult, isLoggedIn: boolean, idToken?: string) => void): void​

설명​

매개변수​

반환 값​

사용 예제​

getUserData(callback: (result: GoogleResult, userData?: GoogleUserData) => void): void​

설명​

매개변수​

반환 값​

사용 예제​

logout(callback: (result: GoogleResult) => void): void​

설명​

매개변수​

반환 값​

사용 예제​

개요

필수 선행 작업

1. nachocode 대시보드의 [ 앱 설정 > 개발자 설정 > 안드로이드 네이티브 설정 ]에서 SHA-1 디지털 지문 확인

2. Firebase 대시보드의 [ 프로젝트 > Authentication > 로그인 방법 ]에서 추가 제공 업체로 [ Google ] 선택 후 사용설정

3. `GoogleService-Info.plist` 를 다운받은 후에 [ 프로젝트 설정 ] 클릭

4. `google-services.json` 파일 다운로드

5. [ Android 앱 ] 탭에서 [ 디지털 지문 추가 ] 클릭

6. 나쵸코드 대시보드에서 복사한 [ SHA-1 디지털 지문 ]을 입력 후 저장

7. nachocode 대시보드의 [ 앱 기능 > 푸시 알림 > 앱 푸시 설정 ]에 다운받은 파일(`GoogleService-Info.plist`, `google-services.json`)을 업로드

8. nachocode 대시보드의 [ 앱 설정 > 개발자 설정 > 구글 네이티브 설정 ]에서 [ 구글 로그인 ] 토글을 활성화하여 앱 설정 완료

9. nachocode 대시보드의 [ 앱 빌드 > 안드로이드 앱 빌드 ]에서 [ 새 버전 만들기 ] 버튼을 클릭하여 빌드

10. 빌드된 aab 파일을 Google Play Console에 업로드 후 [ 테스트 및 출시 > 설정 > 앱 서명 ]에서 앱 서명키 인증서의 [ SHA-1 인증서 지문 ]을 확인

11. [ Google Play Console ]에서 복사한 [ SHA-1 디지털 지문 ]을 입력 후 저장

타입 정의

`GoogleResult`

`GoogleUserData`

메서드 목록

메서드 상세

`login(callback: (result: GoogleResult, idToken?: string, userData?: GoogleUserData) => void): void`

설명

매개변수

반환 값

사용 예제

`isLoggedIn(callback: (result: GoogleResult, isLoggedIn: boolean, idToken?: string) => void): void`

설명

매개변수

반환 값

사용 예제

`getUserData(callback: (result: GoogleResult, userData?: GoogleUserData) => void): void`

설명

매개변수

반환 값

사용 예제

`logout(callback: (result: GoogleResult) => void): void`

설명

매개변수

반환 값

사용 예제