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

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

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

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

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

تعريف البرامج الاعتمادية لخدمات 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.3.0'
}

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

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

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

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

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

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

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

**الجدول 1.** التبعيات الخاصة بـ "خدمات Google Play" التي يجب تضمينها في تطبيقات Android
حالة الاستخدام واسم التبعية	الأجهزة المتوافقة
إعلانات Google على الأجهزة الجوّالة `com.google.android.gms:play-services-ads:24.7.0`	هاتف أو جهاز لوحي
المعرّف الإعلاني على Android‏ (AAID) `com.google.android.gms:play-services-ads-identifier:18.2.0`	هاتف وجهاز لوحي وAndroid TV وChromeOS
الإصدار الخفيف من "إعلانات Google على الأجهزة الجوّالة" `com.google.android.gms:play-services-ads-lite:24.6.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
AppSearch `com.google.android.gms:play-services-appsearch:16.0.1`	هاتف وجهاز لوحي وتلفزيون Android
معرّف مجموعة تطبيقات Android `com.google.android.gms:play-services-appset:16.1.0`	هاتف وجهاز لوحي وAndroid TV وChromeOS
تسجيل الدخول بحساب Google على أجهزة Android `com.google.android.gms:play-services-auth:21.4.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS
SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.3.0`	هاتف أو جهاز لوحي أو جهاز Android Go
Block Store API (includes user credential storage) `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.9.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.9.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
تحسين الإضاءة المنخفضة في الكاميرا `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta06`	هاتف أو جهاز لوحي
Google Cast `com.google.android.gms:play-services-cast:22.2.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
إطار عمل تطبيقات Google Cast‏ (CAF) `com.google.android.gms:play-services-cast-framework:22.2.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-beta02`	هاتف أو جهاز لوحي أو جهاز Android Go
المصادقة باستخدام معيار Fast IDentity Online (FIDO) `com.google.android.gms:play-services-fido:21.2.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
الإصدار 2 من "خدمات ألعاب Google Play" على Android `com.google.android.gms:play-services-games-v2:21.0.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
الإصدار 1 من "خدمات ألعاب Google Play" على Android `com.google.android.gms:play-services-games:24.0.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.2.0`	تمّت إزالة هذا العمود. لمزيد من المعلومات، يُرجى الاطّلاع على تطبيقات Google Play الفورية.
خدمات الموقع الجغرافي على Android `com.google.android.gms:play-services-location:21.3.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
‫Google Maps SDK لنظام التشغيل Android `com.google.android.gms:play-services-maps:19.2.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android `com.google.android.gms:play-services-maps3d:0.1.0`	هاتف أو جهاز لوحي
مسح الرموز الشريطية ضوئيًا باستخدام ML Kit `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
التعرّف على الوجوه في ML Kit `com.google.android.gms:play-services-mlkit-face-detection:17.1.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
تصنيف الصور في ML Kit `com.google.android.gms:play-services-mlkit-image-labeling:16.0.8`	هاتف وجهاز لوحي وAndroid Go وChromeOS
تصنيف الصور المخصّص في ML Kit `com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5`	هاتف وجهاز لوحي و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
تقسيم المواضيع في ML Kit `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.3.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS متوافق مع الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
مكتبات الوصول الآلي (PAL) `com.google.android.gms:play-services-pal:22.1.0`	الهاتف والجهاز اللوحي وAndroid TV متوافق مع الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
عملية التحقّق من جودة قفل الشاشة `com.google.android.gms:play-services-password-complexity:18.1.0`	هاتف، جهاز لوحي، Android Go، ChromeOS، Wear OS متوافق مع الأجهزة التي تعمل بالإصدار 4.4 من نظام التشغيل Android (المستوى 19 من واجهة برمجة التطبيقات) إلى الإصدار 9 من نظام التشغيل Android (المستوى 28 من واجهة برمجة التطبيقات).
محفظة Google (المعروفة سابقًا باسم Google Pay for Passes) `com.google.android.gms:play-services-pay:16.5.0`	هاتف، جهاز لوحي، Android Go، ChromeOS متوافق مع الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 20 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
reCAPTCHA Enterprise لأدوات التطبيقات `com.google.android.gms:play-services-recaptcha:17.1.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
واجهات برمجة تطبيقات SafetyNet (تشمل التصفّح الآمن والتحقّق من التطبيقات) `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.3.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
Tasks API على Android `com.google.android.gms:play-services-tasks:18.4.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
خدمة تسريع الأداء على Android `com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01`	هاتف وجهاز لوحي وAndroid Go وChromeOS
واجهة برمجة التطبيقات TensorFlow Lite GPU Delegate API لخدمات Google Play `com.google.android.gms:play-services-tflite-gpu:16.4.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات Java في TensorFlow Lite لخدمات Google Play `com.google.android.gms:play-services-tflite-java:16.4.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
واجهة برمجة التطبيقات TensorFlow Lite Support API لخدمات Google Play `com.google.android.gms:play-services-tflite-support:16.4.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:19.5.0`	هاتف وجهاز لوحي وAndroid Auto وAndroid Go وChromeOS وWear OS
Wearable Data Layer API `com.google.android.gms:play-services-wearable:19.0.0`	هاتف وجهاز لوحي وساعة Wear OS

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

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

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