자체 앱에서 Google 로그인 통합을 시작하려면 먼저 Google API 콘솔 프로젝트를 구성하고 Android 스튜디오 프로젝트를 설정해야 합니다.
이 과정을 실행하려면 이 페이지의 절차를 따릅니다. 다음 단계에서는 Google 로그인을 앱에 통합하는 방법을 설명합니다.
기본 요건
Android용 Google 로그인에는 다음과 같은 요구사항이 있습니다.
Android 6.0 이상을 실행하며 Google Play 스토어가 포함된 호환되는 Android 지원 기기 또는 Android 4.2.2 이상을 기반으로 Google API 플랫폼을 실행하고 Google Play 서비스 버전 15.0.0 이상이 있는 AVD가 포함된 에뮬레이터
SDK 도구 구성요소를 포함한 Android SDK의 최신 버전 이 SDK는 Android 스튜디오의 Android SDK Manager에서 사용할 수 있습니다.
Android 6.0 (Marshmallow) 이상을 기준으로 컴파일되도록 구성된 프로젝트입니다.
이 가이드는 권장 개발 환경인 Android 스튜디오 사용자를 위해 작성되었습니다.
Google Play 서비스 추가
프로젝트의 최상위 build.gradle 파일에 Google의 Maven 저장소가 포함되어 있는지 확인합니다.
allprojects {
repositories {
google()
// If you're using a version of Gradle lower than 4.1, you must instead use:
// maven {
// url 'https://maven.google.com'
// }
}
}
그런 다음 앱 수준 build.gradle 파일에서 Google Play 서비스를 종속 항목으로 선언합니다.
사용자 인증 정보 페이지에서 웹 애플리케이션 유형 클라이언트 ID를 만듭니다. GoogleSignInOptions 객체를 만들 때 requestIdToken 또는 requestServerAuthCode 메서드에 전달해야 하는 클라이언트 ID 문자열을 확인합니다.
다음 단계
이제 Google API 콘솔 프로젝트를 구성하고 Android 스튜디오 프로젝트를 설정했으므로 앱에 Google 로그인을 통합할 수 있습니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-26(UTC)"],[],[],null,["# Start Integrating Google Sign-In into Your Android App\n\n| **Warning:**\n|\n| **The Google Sign-In for Android API is outdated and no longer supported.**\n| To ensure the continued security and usability of your app, [migrate your Sign in with\n| Google implementation to Credential Manager](/identity/sign-in/credential-manager-siwg) today. Credential Manager\n| supports passkey, password, and federated identity authentication (such as\n| Sign-in with Google), stronger security, and a more consistent user\n| experience.\n|\n| **For Wear developers:** Credential Manager will be supported in Wear OS\n| 5.1 and later on selected watches. Developers actively supporting Wear OS 3, 4\n| and 5.0 devices with Sign in with Google should continue using Google Sign-in\n| for Android for your Wear applications. Sign in with Google support will be\n| available on Credential Manager APIs for these versions of WearOS at a later\n| date.\n\nBefore you can start integrating Google Sign-In in your own app, you must\nconfigure a Google API Console project and set up your Android Studio project.\nThe steps on this page do just that. The [next steps](#next_steps)\nthen describe how to integrate Google Sign-In into your app.\n\nPrerequisites\n-------------\n\nGoogle Sign-In for Android has the following requirements:\n\n- A compatible Android-powered device that runs Android 6.0 or newer and includes the Google Play Store or an emulator with an AVD that runs the Google APIs platform based on Android 4.2.2 or newer and has Google Play services version 15.0.0 or newer.\n- The latest version of the Android SDK, including the SDK Tools component. The SDK is available from the Android SDK Manager in Android Studio.\n- A project configured to compile against Android 6.0 (Marshmallow) or newer.\n\nThis guide is written for users of Android Studio, which is the recommended\ndevelopment environment.\n\nAdd Google Play services\n------------------------\n\nIn your project's top-level `build.gradle` file, ensure that Google's Maven\nrepository is included: \n\n allprojects {\n repositories {\n google()\n\n // If you're using a version of Gradle lower than 4.1, you must instead use:\n // maven {\n // url 'https://maven.google.com'\n // }\n }\n }\n\nThen, in your app-level `build.gradle` file, declare\n[Google Play services](https://developers.google.com/android) as a dependency: \n\n apply plugin: 'com.android.application'\n ...\n\n dependencies {\n implementation 'com.google.android.gms:play-services-auth:21.3.0'\n }\n\nConfigure a Google API Console project\n--------------------------------------\n\n1. Open your project in the [API console](https://console.cloud.google.com/), or create a project if you don't already have one.\n2. On the OAuth consent screen page, make sure all of the information is complete and accurate.\n3. On the Credentials page, create an **Android** type client ID for your app if you don't already have one. You will need to specify your app's package name and SHA-1 certificate fingerprint. See [Authenticating Your\n Client](https://developers.google.com/android/guides/client-auth) for more information.\n\nGet your backend server's OAuth 2.0 client ID\n---------------------------------------------\n\nIf your app [authenticates with a backend server](https://developers.google.com/identity/sign-in/android/backend-auth) or\n[accesses Google APIs from your backend server](/identity/legacy/gsi/offline-access), you need to get\nthe OAuth 2.0 client ID that represents your backend server.\n\nTo create a client ID for your server:\n\n1. Open your project in the [API console](https://console.cloud.google.com/).\n\n2. On the Credentials page, create a **Web application** type client ID. Take\n note of the client ID string, which you will need to pass to the\n `requestIdToken` or `requestServerAuthCode` method when you create the\n `GoogleSignInOptions` object.\n\nNext steps\n----------\n\nNow that you have configured a Google API Console project and set up your\nAndroid Studio project, you can [integrate Google Sign-In](/identity/legacy/gsi/legacy-sign-in) into\nyour app."]]