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

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

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

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

جهاز Android متوافق يعمل بالإصدار 7.0 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 24) أو إصدار أحدث، ومثبَّت عليه تطبيق "متجر Google Play"
محاكي Android مع AVD يشغّل نظام Google APIs الأساسي المستنِد إلى Android 7.0 (المستوى 24 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث

تحديد التبعيات لـ "خدمات Google Play"

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

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

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

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

apply plugin: 'com.android.application'

...

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

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

التحقّق من تثبيت "خدمات Google Play"

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

للتحقّق من توفّر "خدمات 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:25.5.0`	هاتف، جهاز لوحي
المعرِّف الإعلاني على Android‏ (AAID) `com.google.android.gms:play-services-ads-identifier:18.3.0`	هاتف، جهاز لوحي، Android TV،‏ ChromeOS
إصدار خفيف من "إعلانات Google على الأجهزة الجوّالة" `com.google.android.gms:play-services-ads-lite:25.0.0`	هاتف، جهاز لوحي
"إعلانات البحث المخصّص" (CSA) في "AdSense للبحث" (AFS) `com.google.android.gms:play-services-afs-native:19.1.0`	هاتف، جهاز لوحي، ChromeOS
حزمة تطوير البرامج (SDK) لخدمات "إحصاءات Google" لنظام التشغيل Android `com.google.android.gms:play-services-analytics:18.1.1`	تمّت إزالة هذا العمود. استخدِم إحصاءات Google لـ Firebase بدلاً من ذلك.
فهرسة التطبيقات `com.google.android.gms:play-services-appindex:16.2.0`	هاتف، جهاز لوحي، Android TV
AppSearch `com.google.android.gms:play-services-appsearch:16.0.1`	هاتف، جهاز لوحي، 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:22.0.0`	الهاتف، الجهاز اللوحي، Android TV، ‏Auto، ‏Android Go، ‏ChromeOS
SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.3.1`	هاتف، جهاز لوحي، Android Go
واجهة برمجة التطبيقات Block Store API (تتضمّن وحدة تخزين بيانات اعتماد المستخدم) `com.google.android.gms:play-services-auth-blockstore:16.4.0`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
Google Awareness API `com.google.android.gms:play-services-awareness:20.0.0`	الهاتف، الجهاز اللوحي، Auto، ‏Android Go، ‏ChromeOS
فئات الخدمات `com.google.android.gms:play-services-base:18.11.1`	الهواتف والأجهزة اللوحية وأجهزة Android TV وAuto وAndroid Go وChromeOS وWear OS
اختبار الفئات المزيّفة لفئات الأدوات المساعدة `com.google.android.gms:play-services-base-testing:16.2.0`	الهواتف والأجهزة اللوحية وأجهزة Android TV وAuto وAndroid Go وChromeOS وWear OS
المزيد من فئات الأدوات المساعدة `com.google.android.gms:play-services-basement:18.12.0`	الهواتف والأجهزة اللوحية وأجهزة Android TV وAuto وAndroid Go وChromeOS وWear OS
تحسين الإضاءة المنخفضة في الكاميرا `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09`	هاتف، جهاز لوحي
Google Cast `com.google.android.gms:play-services-cast:22.3.1`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
إطار عمل تطبيق Google Cast‏ (CAF) `com.google.android.gms:play-services-cast-framework:22.3.1`	هاتف، جهاز لوحي، 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.1`	الهواتف والأجهزة اللوحية وأجهزة Android TV وAuto وAndroid Go وChromeOS وWear OS
التفاعلات بين الأجهزة (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta02`	هاتف، جهاز لوحي، Android Go
حزمة SDK للتحقّق من المفاتيح `com.google.android.gms:contactkeys:16.0.0`	هاتف، جهاز لوحي
مصادقة الهوية السريعة على الإنترنت (FIDO) `com.google.android.gms:play-services-fido:21.3.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.3.0`	الهاتف، الجهاز اللوحي، Android Go،‏ ChromeOS،‏ Wear OS
Fraud Protect `com.google.android.gms:play-services-fraudprotect:16.0.1`	هاتف، جهاز لوحي، Android Go
الإصدار الثاني من "خدمات ألعاب Google Play" لأجهزة Android `com.google.android.gms:play-services-games-v2:22.1.0`	هاتف، جهاز لوحي، Android TV،‏ Android Go،‏ ChromeOS
الإصدار الثاني من حزمة تطوير البرامج (SDK) الأصلية بلغة C لخدمات ألعاب 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:25.0.0`	تمّت إزالة هذا العمود. يمكنك بدلاً من ذلك استخدام الإصدار 2 من "خدمات ألعاب Google Play".
Matter API `com.google.android.gms:play-services-home:16.0.0`	هاتف، جهاز لوحي
تطبيقات Google Play الفورية `com.google.android.gms:play-services-instantapps:18.2.0`	تمّت إزالة هذا العمود. لمزيد من المعلومات، يُرجى الاطّلاع على تطبيقات Google Play الفورية.
الخدمات المستندة إلى الموقع الجغرافي في Android `com.google.android.gms:play-services-location:21.4.0`	الهواتف والأجهزة اللوحية وأجهزة Android TV وAuto وAndroid Go وChromeOS وWear OS
حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android `com.google.android.gms:play-services-maps:20.1.0`	الهواتف والأجهزة اللوحية وأجهزة Android TV وAuto وAndroid Go وChromeOS وWear OS
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android `com.google.android.gms:play-services-maps3d:16.0.1`	هاتف، جهاز لوحي
تحسين تأثيرات الوسائط `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta09`	هاتف، جهاز لوحي
مُحسِّن الصوت الذكي في Media Effect `com.google.android.gms:play-services-media-effect-studiosound:16.0.0-beta02`	هاتف، جهاز لوحي
مسح الرموز الشريطية ضوئيًا باستخدام حزمة تعلّم الآلة `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`	هاتف، جهاز لوحي، 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
التعرّف على النص باستخدام حزمة تعلّم الآلة `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
التعرّف على النص باللغة اليابانية باستخدام حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
التعرّف على النص باللغة الكورية باستخدام حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
رصد الأجهزة المجاورة والاتصال بها `com.google.android.gms:play-services-nearby:19.5.1`	هاتف، جهاز لوحي، Android TV، ‏Auto، ‏Android Go
عرض تراخيص البرامج المفتوحة المصدر `com.google.android.gms:play-services-oss-licenses:17.5.2`	الهواتف والأجهزة اللوحية وأجهزة Android TV وAuto وAndroid Go وChromeOS متوافقة مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
مكتبات الوصول الآلي (PAL) `com.google.android.gms:play-services-pal:23.0.0`	الهاتف والجهاز اللوحي وAndroid TV متوافق مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 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 Passes) `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
Remote Gestures API `com.google.android.gms:play-services-remotegestures:16.0.0`	هاتف، جهاز لوحي
الإصدار الخامس من "التصفّح الآمن" `com.google.android.gms:play-services-safebrowsing:16.0.0`	الهاتف، الجهاز اللوحي، Android TV، ‏Auto، ‏Android Go، ‏ChromeOS
واجهات برمجة تطبيقات SafetyNet (تشمل التصفّح الآمن والتحقّق من التطبيقات) `com.google.android.gms:play-services-safetynet:18.1.0`	الهاتف، الجهاز اللوحي، Android TV، ‏Auto، ‏Android Go، ‏ChromeOS
Google Tag Manager `com.google.android.gms:play-services-tagmanager:18.3.0`	هاتف، جهاز لوحي، Android TV،‏ Android Go،‏ ChromeOS
‫Tasks API على Android `com.google.android.gms:play-services-tasks:18.4.1`	الهواتف والأجهزة اللوحية وأجهزة Android TV وAuto وAndroid Go وChromeOS وWear OS
خدمة التسريع لنظام التشغيل Android `com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
واجهة برمجة التطبيقات TensorFlow Lite GPU Delegate API لـ "خدمات Google Play" `com.google.android.gms:play-services-tflite-gpu:16.5.0`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
واجهة برمجة التطبيقات TensorFlow Lite Java API لـ "خدمات Google Play" `com.google.android.gms:play-services-tflite-java:16.5.0`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
واجهة TensorFlow Lite Support API لـ "خدمات Google Play" `com.google.android.gms:play-services-tflite-support:16.5.0`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
Thread Network API `com.google.android.gms:play-services-threadnetwork:16.3.0`	هاتف، جهاز لوحي
Trusted Time API `com.google.android.gms:play-services-time:16.0.1`	الهاتف، الجهاز اللوحي، Auto، ‏Android Go، ‏Wear OS
Mobile Vision `com.google.android.gms:play-services-vision:20.1.3`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
‫Google Pay للدفع على أجهزة Android `com.google.android.gms:play-services-wallet:20.0.0`	الهاتف، الجهاز اللوحي، Auto، ‏Android Go، ‏ChromeOS، ‏Wear OS
واجهة برمجة تطبيقات طبقة بيانات الأجهزة القابلة للارتداء `com.google.android.gms:play-services-wearable:20.0.1`	هاتف، جهاز لوحي، Wear OS

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

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

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