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

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

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

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

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

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

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

**الجدول 1.** التبعيات الخاصة بـ "خدمات Google Play" التي يجب تضمينها في تطبيقات Android
حالة الاستخدام واسم التبعية	الأجهزة المتوافقة
إعلانات Google على الأجهزة الجوّالة `com.google.android.gms:play-services-ads:24.4.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.3.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 وChromeOS
تسجيل الدخول بحساب Google على Android `com.google.android.gms:play-services-auth:21.3.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS
SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.2.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.7.2`	هاتف وجهاز لوحي و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.7.1`	هاتف وجهاز لوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
تحسين الإضاءة المنخفضة في الكاميرا `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta03`	الهاتف والجهاز اللوحي
Google Cast `com.google.android.gms:play-services-cast:22.1.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
إطار عمل تطبيقات Google Cast (CAF) `com.google.android.gms:play-services-cast-framework:22.1.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-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.2.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) الأصلية بلغة C لإصدار 2 من "خدمات ألعاب Google Play" على 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: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 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.0.2`	الهاتف والجهاز اللوحي
مسح الرموز الشريطية ضوئيًا باستخدام 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-beta1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرّف على الوجوه في ML Kit `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
تخصيص تصنيف الصور في ML Kit `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
تقسيم الصور إلى مواضيع باستخدام حزمة 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.2.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS متوافق مع الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
مكتبات الوصول الآلي (PAL) `com.google.android.gms:play-services-pal:22.0.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.3.2`	هاتف وجهاز لوحي و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`	الهاتف والجهاز اللوحي والسيارة و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.4.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.6`	الهاتف والجهاز اللوحي وChromeOS
التحقّق الصارم من الإصدار `com.google.android.gms:strict-version-matcher-plugin:1.2.4`	هاتف وجهاز لوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS