البدء بدمج "تسجيل الدخول بحساب Google" في تطبيق Android

تحذير: إنّ ميزة "تسجيل الدخول بحساب Google" لأجهزة Android قديمة ولم تعُد متاحة. لضمان استمرار أمان تطبيقك وقابلية استخدامه، يُرجى نقل البيانات إلى "مدير بيانات الاعتماد" اليوم. يتيح "مدير بيانات الاعتماد" استخدام مفاتيح المرور وكلمة المرور والمصادقة الموحّدة (مثل "تسجيل الدخول باستخدام حساب Google")، وتعزيز مستوى الأمان وتقديم تجربة أكثر اتساقًا للمستخدم.

قبل البدء بدمج ميزة "تسجيل الدخول بحساب Google" في تطبيقك، يجب ضبط مشروع وحدة تحكّم واجهة برمجة تطبيقات Google وإعداد مشروعك على "استوديو Android". ذلك من خلال الخطوات الواردة في هذه الصفحة. بعد ذلك، تصف الخطوات التالية كيفية دمج تسجيل الدخول بحساب Google في تطبيقك.

المتطلّبات الأساسية

يجب أن تتوفر المتطلبات التالية لتسجيل الدخول باستخدام حساب Google على أجهزة Android:

• جهاز Android متوافق يعمل بالإصدار 5.0 من نظام التشغيل Android أو إصدار أحدث، ويتضمّن "متجر Google Play" أو محاكيًا يتضمّن AVD يشغّل نظام Google APIs الأساسي استنادًا إلى الإصدار 4.2.2 من نظام التشغيل Android أو الإصدارات الأحدث مع الإصدار 15.0.0 من "خدمات Google Play" أو إصدار أحدث.
• أحدث إصدار من حزمة Android SDK، بما في ذلك مكوِّن أدوات SDK. تتوفّر حزمة SDK من مدير حزمة تطوير البرامج (SDK) لنظام التشغيل Android في "استوديو Android".
• مشروع تم إعداده للتوافق مع نظام التشغيل Android 5.0 (Lollipop) أو الإصدارات الأحدث.

تم إعداد هذا الدليل لمستخدمي "استوديو Android"، وهو بيئة التطوير التي يُنصح بها.

إضافة خدمات 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 هي إحدى الخدمات التابعة:

apply plugin: 'com.android.application'
    ...

    dependencies {
        implementation 'com.google.android.gms:play-services-auth:21.2.0'
    }

إعداد مشروع وحدة تحكُّم واجهة برمجة تطبيقات Google

1. افتح مشروعك في وحدة تحكم واجهة برمجة التطبيقات أو أنشئ مشروعًا إذا لم يكن لديك مشروع.
2. في صفحة طلب موافقة OAuth، تأكَّد من أنّ جميع المعلومات كاملة ودقيقة.
3. في صفحة "بيانات الاعتماد"، يمكنك إنشاء معرِّف عميل من النوع Android لتطبيقك إذا لم يكن لديك معرِّف عميل من قبل. يجب تحديد اسم حزمة تطبيقك والملف المرجعي لشهادة SHA-1. راجِع مصادقة العميل للحصول على مزيد من المعلومات.

الحصول على معرِّف عميل OAuth 2.0 لخادم الخلفية

إذا كان تطبيقك يصادق باستخدام خادم خلفية أو يصل إلى Google APIs من خادم الخلفية، عليك الحصول على معرِّف عميل OAuth 2.0 الذي يمثّل خادم الخلفية.

لإنشاء معرِّف عميل للخادم:

1. افتح مشروعك في وحدة تحكم واجهة برمجة التطبيقات.

2. في صفحة "بيانات الاعتماد"، أنشِئ معرِّف عميل من النوع تطبيق ويب. دوِّن سلسلة معرّف العميل، والتي ستحتاج إلى تمريرها إلى الطريقة requestIdToken أو requestServerAuthCode عند إنشاء الكائن GoogleSignInOptions.

الخطوات التالية

الآن بعد أن أعددت مشروعًا على وحدة تحكّم واجهة برمجة تطبيقات Google وأعددت مشروعك على "استوديو Android"، يمكنك دمج ميزة "تسجيل الدخول باستخدام حساب Google" في تطبيقك.