شروع به ادغام Google Sign-In در برنامه Android خود کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
قبل از اینکه بتوانید Google Sign-In را در برنامه خود ادغام کنید، باید یک پروژه Google API Console را پیکربندی کنید و پروژه Android Studio خود را راه اندازی کنید. مراحل این صفحه دقیقاً این کار را انجام می دهد. سپس مراحل بعدی نحوه ادغام Google Sign-In را در برنامه خود شرح می دهد.
پیش نیازها
Google Sign-In برای Android دارای شرایط زیر است:
یک دستگاه سازگار با Android که دارای Android نسخه 6.0 یا جدیدتر است و شامل فروشگاه Google Play یا شبیه‌ساز با AVD است که پلتفرم Google APIs را بر اساس Android نسخه 4.2.2 یا جدیدتر اجرا می‌کند و دارای خدمات Google Play نسخه 15.0.0 یا جدیدتر است.
آخرین نسخه Android SDK، از جمله مؤلفه SDK Tools. SDK از Android SDK Manager در Android Studio در دسترس است.
پروژه ای پیکربندی شده برای کامپایل در برابر Android 6.0 (Marshmallow) یا جدیدتر.
این راهنما برای کاربران اندروید استودیو که محیط توسعه پیشنهادی است نوشته شده است.
خدمات Google Play را اضافه کنید
در فایل build.gradle سطح بالای پروژه خود، مطمئن شوید که مخزن Maven 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'
// }
}
}
سپس، در فایل build.gradle در سطح برنامه، خدمات Google Play را به عنوان یک وابستگی اعلام کنید:
پروژه خود را در کنسول API باز کنید یا اگر قبلاً ندارید پروژه ای ایجاد کنید.
در صفحه نمایش رضایت OAuth، مطمئن شوید که همه اطلاعات کامل و دقیق هستند.
اگر قبلاً ندارید، در صفحه اعتبارنامه، یک شناسه کلاینت نوع Android برای برنامه خود ایجاد کنید. باید نام بسته برنامه و اثر انگشت گواهینامه SHA-1 را مشخص کنید. برای اطلاعات بیشتر به احراز هویت مشتری خود مراجعه کنید.
شناسه مشتری OAuth 2.0 سرور باطن خود را دریافت کنید
در صفحه Credentials، یک شناسه مشتری نوع برنامه وب ایجاد کنید. به رشته شناسه مشتری توجه داشته باشید، که باید هنگام ایجاد شیء GoogleSignInOptions ، آن را به روش requestIdToken یا requestServerAuthCode منتقل کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
