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

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

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

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

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

الإفصاح عن التبعيات لخدمة "خدمات Google Play"

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

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

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

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

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

للتحقّق من توفّر "خدمات 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:23.6.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:23.6.0`	الهاتف والجهاز اللوحي
إعلانات البحث المخصّصة في "AdSense للبحث" `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:21.3.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS
SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.1.0`	الهاتف والجهاز اللوحي وAndroid Go
حظر 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:19.1.0`	الهاتف والجهاز اللوحي والسيارة وAndroid Go وChromeOS
فئات الخدمات `com.google.android.gms:play-services-base:18.5.0`	الهاتف والجهاز اللوحي و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.5.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
Google Cast `com.google.android.gms:play-services-cast:22.0.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
إطار عمل تطبيقات Google Cast (CAF) `com.google.android.gms:play-services-cast-framework:22.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.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.1.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.2.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS
الإصدار 2 من "خدمات ألعاب Google Play" لأجهزة Android `com.google.android.gms:play-services-games-v2:20.1.2`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
حزمة تطوير البرامج (SDK) لإصدار 2 من "خدمات ألعاب 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: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 التوافق مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو إصدار أحدث
خدمات الموقع الجغرافي لنظام التشغيل Android `com.google.android.gms:play-services-location:21.3.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
حزمة تطوير البرامج (SDK) لـ "خرائط Google" لنظام التشغيل Android `com.google.android.gms:play-services-maps:19.0.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
مسح الرموز الشريطية ضوئيًا باستخدام حزمة 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
تصنيف الصور باستخدام حزمة 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
التعرّف على النصوص باللغة الصينية باستخدام حزمة ML Kit `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النصوص باللغة الديفاناغارية باستخدام حزمة ML Kit `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.1.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS التوافق مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو إصدار أحدث
مكتبات الوصول الآلي (PAL) `com.google.android.gms:play-services-pal:21.0.0`	الهاتف والجهاز اللوحي وAndroid TV الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 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
واجهات برمجة تطبيقات SafetyNet (تتضمّن التصديق على الجهاز والتصفح الآمن وGoogle reCAPTCHA وإثبات ملكية التطبيق) `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.1.1`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
واجهة برمجة التطبيقات Tasks API على Android `com.google.android.gms:play-services-tasks:18.2.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
خدمة Acceleration Service لنظام التشغيل 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
TensorFlow Lite Java API لخدمة 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.2.1`	الهاتف والجهاز اللوحي
Trusted Time API `com.google.android.gms:play-services-time:16.0.0`	الهاتف والجهاز اللوحي وAndroid Auto وAndroid Go وWear OS
الرؤية على الأجهزة الجوّالة `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 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