تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إعداد خدمات Google Play

لتطوير تطبيق باستخدام واجهات برمجة تطبيقات خدمات Google Play، اتبع الإرشادات في هذه الصفحة لإعداد مشروعك باستخدام حزم SDK ذات الصلة، والتي تتوفر من مستودع Google Maven.

لاختبار تطبيقك عند استخدام خدمات Google Play، يجب استخدام أحد الخيارات التالية:

جهاز Android متوافق يعمل بالإصدار 4.4 من نظام التشغيل Android (المستوى 19 لواجهة برمجة التطبيقات) أو إصدار أحدث وتم تثبيت تطبيق متجر Google Play عليه.
محاكي Android بإصدار AVD يعمل على تشغيل نظام Google APIs استنادًا إلى Android 4.4 (مستوى واجهة برمجة التطبيقات 19) أو الإصدارات الأحدث.

تعريف التبعيات لخدمات Google Play

لتطوير الميزات التي تعتمد على واجهات برمجة التطبيقات لخدمات Google Play في تطبيقك، يمكنك إكمال الخطوات التالية:

افتح ملف build.gradle داخل دليل وحدة تطبيقك.

ملاحظة: تحتوي مشاريع Android Studio على ملف build.gradle ذي المستوى الأعلى وملف build.gradle لكل وحدة. تأكد من تعديل الملف لوحدة تطبيقك. تعرَّف على المزيد من المعلومات حول إنشاء مشروعك باستخدام أداة Gradle.
عليك تضمين التبعية لحزمة تطوير البرامج (SDK) تلك التي يتطلبها تطبيقك لكل حزمة تطوير برامج (SDK). تتضمن هذه الصفحة قسمًا يسرد العناصر الشائعة لخدمات Google Play لتطبيقات Android. قد تحتاج أيضًا إلى إضافة تبعيات Firebase إلى مشروعك.
احفظ التغييرات وزامن مشروعك.

يعرض المقتطف التالي مثالاً على ملف build.gradle يستخدم مكتبة المواقع الجغرافية:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.0.1'
}

يتم بشكل دوري طرح إصدارات جديدة من حزم SDK لخدمات Google Play مع إصلاحات أخطاء وميزات جديدة. ويتم الإعلان عن هذه التحديثات في ملاحظات الإصدار. إذا كان تطبيقك يستخدم تبعية تم تحديثها، يمكنك التغيير إلى أحدث إصدار في تبعيات تطبيقك للاستفادة من هذه الإصلاحات.

التحقق مما إذا كان قد تم تثبيت خدمات Google Play

كما هو موضّح في النظرة العامة على خدمات Google Play، تتلقى خدمات Google Play تحديثات تلقائية على نظام التشغيل Android 4.4 (مستوى واجهة برمجة التطبيقات 19) والإصدارات الأحدث من خلال تطبيق "متجر Google Play"، ولكن أجهزة Android التي لا تتضمن "متجر Google Play" لم يتم تثبيت خدمات Google Play عليها. إذا كان تطبيقك يعمل على أجهزة بدون خدمات Google Play، فقد تحتاج إلى التحقق لمعرفة ما إذا كانت خدمات Google Play مثبتة على الجهاز قبل محاولة استخدام Google APIs، أو تمكين الميزات في تطبيقك التي تتطلب تشغيل خدمات Google Play.

للتحقق من توفُّر خدمات Google Play على الجهاز، استخدِم طريقة isGooglePlayServicesAvailable().

ثم لبدء الاتصال بخدمات Google Play، أو معرفة كيفية اكتشاف ما إذا كان إصدار خدمات Google Play المثبّتًا يتوافق مع واجهة برمجة تطبيقات معينة، اقرأ الدليل حول الدخول إلى Google APIs.

ملحقات خدمات Google Play

يدرج الجدول التالي التبعيات لخدمات Google Play التي يمكنك تضمينها في تطبيق Android. يمكنك تصفية القائمة بحسب نوع الجهاز عن طريق تحديد أحد الأزرار، ويمكنك البحث عن حالة استخدام محددة أو اسم التبعية عن طريق إدخال نص في المربع الذي يظهر بعد الأزرار.

**الجدول 1.** خدمات Google Play التي يمكن تضمينها في تطبيقات Android
حالة الاستخدام واسم التبعية	الأجهزة المعتمدة
إعلانات Google للأجهزة الجوّالة `com.google.android.gms:play-services-ads:21.5.0`	هاتف، جهاز لوحي
معرّف إعلانات Android (AAID) `com.google.android.gms:play-services-ads-identifier:18.0.1`	الهاتف والجهاز اللوحي وAndroid TV ونظام التشغيل Chrome
إصدار خفيف من "إعلانات Google" للأجهزة الجوّالة `com.google.android.gms:play-services-ads-lite:21.5.0`	هاتف، جهاز لوحي
إعلانات البحث المخصّص (CSA) من AdSense للبحث (CSA) `com.google.android.gms:play-services-afs-native:19.0.3`	الهاتف والجهاز اللوحي ونظام التشغيل Chrome
حزمة تطوير البرامج (SDK) لخدمات "إحصاءات Google" لنظام التشغيل Android `com.google.android.gms:play-services-analytics:18.0.2`	متوقف. استخدم Google Analytics for Firebase بدلاً من ذلك.
فهرس التطبيقات `com.google.android.gms:play-services-appindex:16.1.0`	هاتف، جهاز لوحي، Android TV
رقم تعريف مجموعة تطبيقات Android `com.google.android.gms:play-services-appset:16.0.2`	الهاتف والجهاز اللوحي وAndroid TV ونظام التشغيل Chrome
تسجيل الدخول بحساب Google لأجهزة Android `com.google.android.gms:play-services-auth:20.4.1`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS
واجهة برمجة تطبيقات استرداد الرسائل القصيرة SMS `com.google.android.gms:play-services-auth-api-phone:18.0.1`	هاتف، جهاز لوحي، Android Go
حظر واجهة برمجة تطبيقات المتجر (بما في ذلك وحدة تخزين بيانات اعتماد المستخدم) `com.google.android.gms:play-services-auth-blockstore:16.1.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Google Awareness API `com.google.android.gms:play-services-awareness:19.0.1`	الهاتف والجهاز اللوحي وAuto وAndroid Go ونظام التشغيل Chrome
فئات الخدمات `com.google.android.gms:play-services-base:18.2.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
اختبار السلع المزيفة لحصص المرافق `com.google.android.gms:play-services-base-testing:16.0.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
المزيد من فئات المرافق `com.google.android.gms:play-services-basement:18.1.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
Google Cast `com.google.android.gms:play-services-cast:21.2.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
إطار عمل Google Cast (CAF) `com.google.android.gms:play-services-cast-framework:21.2.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
أجهزة استقبال Android TV `com.google.android.gms:play-services-cast-tv:20.0.0`	Android TV
ماسح الرمز البرمجي من Google `com.google.android.gms:play-services-code-scanner:16.0.0-beta3`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
حزمة شبكة Chromium (Cronet) `com.google.android.gms:play-services-cronet:18.0.1`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
التفاعلات بين الأجهزة (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta01`	هاتف، جهاز لوحي، Android Go
المصادقة السريعة للكيان على الإنترنت (FIDO) `com.google.android.gms:play-services-fido:19.0.1`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS يتوفّر هذا الخيار على الأجهزة التي تعمل بنظام التشغيل Android 7.0 (مستوى واجهة برمجة التطبيقات 24) أو الإصدارات الأحدث.
Google Fit API لنظام التشغيل Android `com.google.android.gms:play-services-fitness:21.1.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games-v2:17.0.0`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
الإصدار الثاني من حزمة تطوير البرامج (SDK) لخدمات "ألعاب Google Play" الإصدار 2 لنظام التشغيل Android `com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
الإصدار الأول من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games:23.1.0`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
Matter API `com.google.android.gms:play-services-home:16.0.0`	هاتف، جهاز لوحي
تطبيقات Google Play الفورية `com.google.android.gms:play-services-instantapps:18.0.1`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS يتوفّر هذا الخيار على الأجهزة التي تعمل بنظام التشغيل Android 5.0 (مستوى واجهة برمجة التطبيقات 21) والإصدارات الأحدث.
موفِّر الموقع المدمج لنظام التشغيل Android (يشمل التعرّف على الأنشطة وتحديد السياج الجغرافي) `com.google.android.gms:play-services-location:21.0.1`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android `com.google.android.gms:play-services-maps:18.1.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
فحص الرمز الشريطي من خلال ML Kit `com.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على الوجوه في "تعلّم الآلة" `com.google.android.gms:play-services-mlkit-face-detection:17.1.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
تصنيف صور حزمة أدوات تعلّم الآلة `com.google.android.gms:play-services-mlkit-image-labeling:16.0.8`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
تصنيف مخصّص لصورة حزمة أدوات تعلّم الآلة `com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على لغة ML Kit `com.google.android.gms:play-services-mlkit-language-id:17.0.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
الردّ الذكي من ML Kit `com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النص في مجموعة أدوات تعلّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition:18.0.2`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
اكتشاف الأجهزة المجاورة والاتصال بها `com.google.android.gms:play-services-nearby:18.4.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go
عرض تراخيص مفتوحة المصدر `com.google.android.gms:play-services-oss-licenses:17.0.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go ونظام التشغيل Chrome يتوفّر ذلك على الأجهزة التي تعمل بنظام التشغيل Android 5.0 (مستوى واجهة برمجة التطبيقات 21) أو الإصدارات الأحدث.
فحص جودة قفل الشاشة `com.google.android.gms:play-services-password-complexity:18.0.1`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS متاح على الأجهزة التي تعمل بنظام التشغيل Android 4.4 (مستوى واجهة برمجة التطبيقات 19) إلى Android 9 (مستوى واجهة برمجة التطبيقات 28).
Google Pay للبطاقات `com.google.android.gms:play-services-pay:16.1.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS يتوفّر هذا الإعداد على الأجهزة التي تعمل بنظام التشغيل Android 5.0 (مستوى واجهة برمجة التطبيقات 20) والإصدارات الأحدث.
reCAPTCHA Enterprise لأدوات قياس أداء التطبيقات `com.google.android.gms:play-services-recaptcha:17.0.1`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
واجهات برمجة تطبيقات SafetyNet (بما في ذلك مصادقة الجهاز والتصفّح الآمن و reCAPTCHA والتحقق من التطبيقات) `com.google.android.gms:play-services-safetynet:18.0.1`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS
إدارة العلامات من Google `com.google.android.gms:play-services-tagmanager:18.0.2`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
واجهة برمجة تطبيقات "مهام Google" على Android `com.google.android.gms:play-services-tasks:18.0.2`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
واجهة برمجة تطبيقات المفوّض في وحدة معالجة الرسومات من TensorFlow Lite لخدمات Google Play `com.google.android.gms:play-services-tflite-gpu:16.1.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات جافا من TensorFlow Lite لخدمات Google Play `com.google.android.gms:play-services-tflite-java:16.0.1`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات دعم TensorFlow Lite لخدمات Google Play `com.google.android.gms:play-services-tflite-support:16.0.1`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات شبكة Thread `com.google.android.gms:play-services-threadnetwork:16.0.0-beta02`	هاتف، جهاز لوحي
الرؤية على الأجهزة الجوّالة `com.google.android.gms:play-services-vision:20.1.3`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Google Pay للدفع على الأجهزة التي تعمل بنظام التشغيل Android `com.google.android.gms:play-services-wallet:19.1.0`	الهاتف والجهاز اللوحي وAuto وAndroid Go وChromeOS وWear OS
واجهة برمجة تطبيقات طبقة البيانات القابلة للارتداء `com.google.android.gms:play-services-wearable:18.0.0`	هاتف، جهاز لوحي، Wear OS

مكوّنات إضافية من Gradle

تتضمن خدمات Google Play أيضًا العديد من مكوّنات Gradle الإضافية، كما هو موضّح في الجدول التالي. تجدر الإشارة إلى أن الأزرار التي تظهر قبل الجدول السابق لا تغيّر المعلومات التي تظهر في هذا الجدول.

**الجدول 2.** قائمة مكوّنات Gradle الإضافية المضمَّنة في خدمات Google Play
اسم الحالة واسم المكوّن الإضافي Gradle	الأجهزة المعتمدة
عرض تراخيص مفتوحة المصدر `com.google.android.gms:oss-licenses-plugin:0.10.6`	الهاتف والجهاز اللوحي ونظام التشغيل Chrome
فحص إصدار صارم `com.google.android.gms:strict-version-matcher-plugin:1.2.4`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS