سيتم إيقاف "مكتبة منصّة JavaScript لتسجيل الدخول إلى Google" على الويب. لن تكون المكتبة متاحة للتنزيل بعد 31 آذار (مارس) 2023. وبدلاً من ذلك، استخدم خدمات Google Identity الجديدة على الويب.
حسب الإعدادات التلقائية، يتم الآن حظر استخدام معرّفات Client ID الجديدة في مكتبة النظام الأساسي، ولن تتأثر معرّفات Client ID الحالية. يمكن لمعرّفات العملاء الجديدة التي تم إنشاؤها قبل 29 تموز (يوليو) 2022 ضبط `plugin_name` لتفعيل استخدام "منصة Google" الأساسية.

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

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

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

يتطلّب تسجيل الدخول بحساب Google لنظام التشغيل Android المتطلبات التالية:

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

تم إعداد هذا الدليل لمستخدمي "استوديو 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 باعتبارها اعتمادية:

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

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

ضبط مشروع Google API Console

لتهيئة مشروع وحدة تحكم Google API، انقر على الزر أدناه وحدّد اسم حزمة تطبيقك عند مطالبتك بذلك. وستحتاج أيضًا إلى توفير تجزئة SHA-1 لشهادة التوقيع. يُرجى مراجعة مصادقة البرنامج للحصول على معلومات.

ضبط مشروع

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

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

  1. افتح صفحة بيانات الاعتماد في وحدة تحكم واجهة برمجة التطبيقات.
  2. معرّف العميل من نوع تطبيق الويب هو معرّف عميل OAuth 2.0 في الخادم الخلفي.

تمرير معرِّف العميل هذا إلى الطريقة requestIdToken أو requestServerAuthCode عند إنشاء الكائن GoogleSignInOptions

الخطوات اللاحقة

الآن وبعد ضبط مشروع وحدة تحكُّم Google API وإعداد مشروع Android Studio، يمكنك دمج تسجيل الدخول بحساب Google في تطبيقك.