Bắt đầu tích hợp tính năng Đăng nhập bằng Google vào ứng dụng Android
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trước khi có thể bắt đầu tích hợp tính năng Đăng nhập bằng Google vào ứng dụng của riêng mình, bạn phải định cấu hình dự án Google API Console và thiết lập dự án Android Studio.
Các bước trên trang này sẽ giúp bạn thực hiện việc đó. Sau đó, các bước tiếp theo sẽ mô tả cách tích hợp tính năng Đăng nhập bằng Google vào ứng dụng của bạn.
Điều kiện tiên quyết
Đăng nhập bằng Google cho Android có các yêu cầu sau:
Một thiết bị chạy Android tương thích chạy Android 6.0 trở lên và có Cửa hàng Google Play hoặc một trình mô phỏng có AVD chạy nền tảng API của Google dựa trên Android 4.2.2 trở lên và có Dịch vụ Google Play phiên bản 15.0.0 trở lên.
Phiên bản mới nhất của SDK Android, bao gồm cả thành phần Bộ công cụ SDK. Bạn có thể tải SDK này qua Trình quản lý SDK Android trong Android Studio.
Một dự án được định cấu hình để biên dịch cho Android 6.0 (Marshmallow) trở lên.
Hướng dẫn này được viết cho người dùng Android Studio, đây là môi trường phát triển được đề xuất.
Thêm Dịch vụ Google Play
Trong tệp build.gradle cấp cao nhất của dự án, hãy đảm bảo rằng bạn đã thêm kho lưu trữ Maven của Google:
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'
// }
}
}
Sau đó, trong tệp build.gradle ở cấp ứng dụng, hãy khai báo Dịch vụ Google Play làm phần phụ thuộc:
Định cấu hình dự án Bảng điều khiển API của Google
Mở dự án của bạn trong Bảng điều khiển API hoặc tạo dự án nếu bạn chưa có dự án.
Trên trang màn hình đồng ý OAuth, hãy đảm bảo rằng tất cả thông tin đều đầy đủ và chính xác.
Trên trang Thông tin xác thực, hãy tạo mã ứng dụng loại Android cho ứng dụng của bạn nếu bạn chưa có. Bạn sẽ cần chỉ định tên gói và vân tay số chứng chỉ SHA-1 của ứng dụng. Hãy xem phần Xác thực ứng dụng để biết thêm thông tin.
Lấy mã ứng dụng khách OAuth 2.0 của máy chủ phụ trợ
Trên trang Thông tin xác thực, hãy tạo mã ứng dụng loại Ứng dụng web. Ghi lại chuỗi mã ứng dụng khách mà bạn cần truyền vào phương thức requestIdToken hoặc requestServerAuthCode khi tạo đối tượng GoogleSignInOptions.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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."]]
