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

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

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

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

جهاز Android متوافق يعمل بنظام التشغيل Android 7.0 (المستوى 24 من واجهة برمجة التطبيقات) أو إصدار أحدث ومثبَّت عليه تطبيق "متجر Google Play"
‫Android Emulator مع AVD يشغّل منصة Google APIs استنادًا إلى الإصدار 7.0 من Android (المستوى 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 APIs أو تفعيل الميزات التي تتطلّبها.

للتحقّق من توفّر "خدمات 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 (تتضمّن وحدة تخزين بيانات اعتماد المستخدم) `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`	الهواتف والأجهزة اللوحية وAndroid 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:23.0.0`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
إطار عمل تطبيق Google Cast‏ (CAF) `com.google.android.gms:play-services-cast-framework:23.0.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.1`	الهاتف، الجهاز اللوحي، Android TV، ‏Auto، ‏Android Go، ‏ChromeOS، ‏Wear OS
التفاعلات بين الأجهزة (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta03`	هاتف، جهاز لوحي، 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
الحماية من الاحتيال `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) لـ "خدمات ألعاب Google Play" بلغة C الأصلية لنظام التشغيل 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-beta10`	الهاتف والجهاز اللوحي
مُحسِّن الصوت الذكي في Media Effect `com.google.android.gms:play-services-media-effect-studiosound:16.0.0-beta03`	الهاتف والجهاز اللوحي
مسح الرموز الشريطية ضوئيًا باستخدام حزمة تعلّم الآلة `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.2`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
التعرّف على النص باللغة الصينية باستخدام حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.2`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
التعرّف على النص باستخدام حزمة تعلّم الآلة للغة الديفنغارية `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.2`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
التعرّف على النص باللغة اليابانية باستخدام حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.2`	هاتف، جهاز لوحي، Android Go،‏ ChromeOS
التعرّف على النصوص باللغة الكورية باستخدام حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.2`	هاتف، جهاز لوحي، 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.3`	الهواتف والأجهزة اللوحية وأجهزة 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 للبطاقات) `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
‫LiteRT لـ "خدمات Google Play" `com.google.android.gms:play-services-litert:17.0.0`	الهاتف، الجهاز اللوحي، 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
Wearable Data Layer API `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