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

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

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

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

جهاز Android متوافق يعمل بالإصدار 7.0 (المستوى 24 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث من Android، وأن يكون تطبيق "متجر 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" تلقائيًا على أجهزة Android 7.0 (المستوى 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.0`	الهاتف والجهاز اللوحي و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 متوافق مع الأجهزة التي تعمل بالإصدار 7.0 من نظام التشغيل Android (المستوى 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
الإصدار 2 من "خدمات ألعاب 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.0.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android `com.google.android.gms:play-services-maps3d:0.2.2`	هاتف أو جهاز لوحي
تحسين تأثيرات الوسائط `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08`	هاتف أو جهاز لوحي
Media Effect Studio Sound `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 متوافق مع الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 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`	هاتف، جهاز لوحي
الإصدار 5 من "التصفّح الآمن" `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
واجهة برمجة تطبيقات Java في TensorFlow Lite لخدمات 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