본문으로 건너뛰기

구글 (google) - 레퍼런스

Thumbnail Image

🚀 추가된 버전 : SDKSDKv1.5.0 AndroidAndroidv1.5.0 iOSiOSv1.5.0
🔔 최신화 일자: 2026-04-08

연동을 마치셨나요?

SDK 메서드를 사용하기 위해선 필수 선행 작업으로 연동하기를 마쳐야합니다.

개요​

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

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

타입 정의​

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'요청 성공 또는 실패 상태
statusCodenumber상태 코드 (성공 시 200)
messagestring (optional)오류 메시지 (실패 시 반환)

GoogleUserData​

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

export declare type GoogleUserData = {
  uid: string;
  email?: string;
  displayName?: string;
  photoURL?: string;
  phoneNumber?: string;
  isEmailVerified: boolean;
  providerId?: string;
};
필드타입설명
uidstring사용자 고유 식별자
emailstring이메일 주소 (optional)
displayNamestring사용자 이름 (optional)
photoURLstring프로필 사진 URL (optional)
phoneNumberstring전화번호 (optional)
isEmailVerifiedboolean이메일 인증 여부
providerIdstring인증 제공자 ID (optional)

메서드 목록​

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

메서드 상세​

login(callback)​

주의

연동하기가 완료되어야 사용할 수 있습니다.

타입 정의​

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

설명​

구글 네이티브 로그인 요청을 수행합니다.
로그인 성공 시 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)​

주의

연동하기가 완료되어야 사용할 수 있습니다.

타입 정의​

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

설명​

현재 사용자가 구글 네이티브 로그인 상태인지 확인합니다.
로그인 여부(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)​

주의

연동하기가 완료되어야 사용할 수 있습니다.

타입 정의​

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

설명​

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

매개변수​

이름타입필수 여부설명
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)​

주의

연동하기가 완료되어야 사용할 수 있습니다.

타입 정의​

function logout(callback?: (result: GoogleResult) => void): void;

설명​

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

매개변수​

이름타입필수 여부설명
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가 반환됩니다.