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

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

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

لاختبار تطبيقك أثناء استخدام "خدمات Google Play"، يجب استخدام إحدى التالي:

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

توضيح الموارد الاعتمادية لخدمات Google Play

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

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

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

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

apply plugin: 'com.android.application'

...

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

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

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

كما هو موضّح في نظرة عامة حول خدمات Google Play، تتلقّى "خدمات Google Play" تحديثات تلقائية على نظام التشغيل Android 6.0 (مستوى واجهة برمجة التطبيقات 23) والإصدارات الأحدث من خلال تطبيق "متجر Google Play". ولكن بالنسبة إلى أجهزة Android التي لا تستخدم Google Play "خدمات Google Play" غير مثبَّتة في "متجر 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:23.3.0`	هاتف، جهاز لوحي
المعرّف الإعلاني على Android (AAID) `com.google.android.gms:play-services-ads-identifier:18.1.0`	الهاتف والجهاز اللوحي وAndroid TV وChromeOS
الإصدار الخفيف من "إعلانات Google على الأجهزة الجوّالة" `com.google.android.gms:play-services-ads-lite:23.3.0`	هاتف، جهاز لوحي
إعلانات البحث المخصّص في "AdSense للبحث" `com.google.android.gms:play-services-afs-native:19.1.0`	الهاتف والجهاز اللوحي ونظام التشغيل ChromeOS
حزمة تطوير البرامج (SDK) لخدمات "إحصاءات Google" لنظام التشغيل Android `com.google.android.gms:play-services-analytics:18.1.0`	تمّت إزالة هذا العمود. استخدِم إحصاءات Google لبرنامج Firebase بدلاً منه.
فهرس التطبيقات `com.google.android.gms:play-services-appindex:16.2.0`	الهاتف والجهاز اللوحي وAndroid TV
AppSearch `com.google.android.gms:play-services-appsearch:16.0.0`	الهاتف والجهاز اللوحي وAndroid TV
معرّف مجموعة تطبيقات Android `com.google.android.gms:play-services-appset:16.1.0`	الهاتف والجهاز اللوحي وAndroid TV وChromeOS
تسجيل الدخول بحساب Google لأجهزة Android `com.google.android.gms:play-services-auth:21.2.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS
واجهة برمجة التطبيقات SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.1.0`	الهاتف، الجهاز اللوحي، Android Go
حظر واجهة برمجة التطبيقات Store (بما في ذلك وحدة تخزين بيانات اعتماد المستخدم) `com.google.android.gms:play-services-auth-blockstore:16.4.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات Google Awareness API `com.google.android.gms:play-services-awareness:19.1.0`	هاتف، جهاز لوحي، Auto، Android Go، ChromeOS
فئات المرافق `com.google.android.gms:play-services-base:18.5.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
اختبار المواد المزيّفة لفئات الخدمات `com.google.android.gms:play-services-base-testing:16.1.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
المزيد من فئات المرافق `com.google.android.gms:play-services-basement:18.4.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
Google Cast `com.google.android.gms:play-services-cast:21.5.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
إطار عمل تطبيق Google Cast (CAF) `com.google.android.gms:play-services-cast-framework:21.5.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
Google Code Scanner `com.google.android.gms:play-services-code-scanner:16.1.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
حزمة شبكة Chromium (Cronet) `com.google.android.gms:play-services-cronet:18.1.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
التفاعلات من جهاز إلى آخر (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta01`	الهاتف، الجهاز اللوحي، Android Go
مصادقة Fast IDentity على الإنترنت (FIDO) `com.google.android.gms:play-services-fido:21.1.0`	هاتف وجهاز لوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS متوافق مع الأجهزة التي تعمل بالإصدار Android 7.0 (المستوى 24 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
Google Fit API لنظام التشغيل Android وRecording API على الأجهزة الجوّالة (لبيانات اللياقة البدنية للمستخدم) `com.google.android.gms:play-services-fitness:21.2.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS وWear OS
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games-v2:20.1.2`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
الإصدار الثاني من حزمة تطوير البرامج (SDK) الأصلية لـ "خدمات ألعاب Google Play" لنظام التشغيل 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.2.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.1.0`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS يتوفّر هذا الخيار على الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
خدمات الموقع الجغرافي لنظام التشغيل Android `com.google.android.gms:play-services-location:21.3.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android `com.google.android.gms:play-services-maps:19.0.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
مسح الرمز الشريطي لحزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
الماسح الضوئي للمستندات في حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1`	هاتف وجهاز لوحي و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-beta5`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرّف على اللغة في أداة تعلّم الآلة `com.google.android.gms:play-services-mlkit-language-id:17.0.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
الرد السريع في حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
تصنيف مواضيع "حزمة تعلّم الآلة" `com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرّف على النص في ML Kit `com.google.android.gms:play-services-mlkit-text-recognition:19.0.1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرُّف على النص في مجموعة أدوات تعلُّم الآلة باللغة الصينية `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرّف على النص في لغتَي الديفاناغارية من خلال تعلُّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرّف على النصوص من خلال ML Kit للّغة اليابانية `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرّف على النص في ML Kit باللغة الكورية `com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
اكتشاف الأجهزة المجاورة والاتصال بها `com.google.android.gms:play-services-nearby:19.3.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go
عرض تراخيص البرامج المفتوحة المصدر `com.google.android.gms:play-services-oss-licenses:17.1.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS متوافق مع الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
التحقّق من جودة قفل الشاشة `com.google.android.gms:play-services-password-complexity:18.1.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS يتوفّر هذا الخيار على الأجهزة التي تعمل بالإصدارات من Android 4.4 (المستوى 19 من واجهة برمجة التطبيقات) إلى Android 9 (المستوى 28 من واجهة برمجة التطبيقات).
محفظة Google (المعروفة سابقًا باسم Google Pay for Cards) `com.google.android.gms:play-services-pay:16.5.0`	الهاتف والجهاز اللوحي وAndroid Go ونظام التشغيل ChromeOS يتوفّر هذا الخيار على الأجهزة التي تعمل بالإصدار Android 5.0 (المستوى 20 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
reCAPTCHA Enterprise لأدوات التطبيق `com.google.android.gms:play-services-recaptcha:17.1.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
واجهات برمجة تطبيقات SafetyNet (تشمل مصادقة الجهاز والتصفّح الآمن و reCAPTCHA وإثبات ملكية التطبيق) `com.google.android.gms:play-services-safetynet:18.1.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS
إدارة العلامات من Google `com.google.android.gms:play-services-tagmanager:18.1.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
Tasks API على Android `com.google.android.gms:play-services-tasks:18.2.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
خدمة Acceleration Service لنظام التشغيل Android `com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01`	هاتف وجهاز لوحي وAndroid Go وChromeOS
TensorFlow Lite GPU Delegate API لخدمات Google Play `com.google.android.gms:play-services-tflite-gpu:16.2.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
TensorFlow Lite Java API لخدمات Google Play `com.google.android.gms:play-services-tflite-java:16.2.0-beta02`	هاتف وجهاز لوحي وAndroid Go وChromeOS
TensorFlow Lite Support API لخدمات Google Play `com.google.android.gms:play-services-tflite-support:16.1.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات Thread Network `com.google.android.gms:play-services-threadnetwork:16.0.1`	هاتف، جهاز لوحي
الرؤية على الأجهزة الجوّالة `com.google.android.gms:play-services-vision:20.1.3`	هاتف وجهاز لوحي وAndroid Go وChromeOS
Google Pay للدفعات على أجهزة Android `com.google.android.gms:play-services-wallet:19.4.0`	هاتف، جهاز لوحي، Auto، Android Go، ChromeOS، Wear OS
Wearable Data Layer API `com.google.android.gms:play-services-wearable:18.2.0`	هاتف، جهاز لوحي، Wear OS

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

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

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