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

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

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

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

جهاز Android متوافق يعمل بالإصدار 6.0 (المستوى 23 من واجهة برمجة التطبيقات) أو إصدار أحدث ومزوّد بتطبيق "متجر Google Play"
محاكي Android المزوّد بAVD الذي يشغّل منصّة Google APIs استنادًا إلى Android 6.0 (المستوى 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" على الأجهزة التي لا تتضمّن "متجر 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`	الهاتف والجهاز اللوحي
إعلانات البحث المخصّصة في "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.2.0`	الهاتف والجهاز اللوحي و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:19.1.0`	الهاتف والجهاز اللوحي والسيارة وAndroid Go وChromeOS
فئات الخدمات `com.google.android.gms:play-services-base:18.7.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.7.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
تحسين الإضاءة المنخفضة في الكاميرا `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta01`	الهاتف والجهاز اللوحي
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 تتوفّر على الأجهزة التي تعمل بنظام التشغيل 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:21.0.0`	الهاتف والجهاز اللوحي و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.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
تحديد اللغة باستخدام 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: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 التوافق مع الأجهزة التي تعمل بنظام التشغيل 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 (تشمل التصفّح الآمن وتطبيق ميزة "التحقّق من التطبيقات") `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.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 Services `com.google.android.gms:play-services-tflite-gpu:16.4.0`	الهاتف والجهاز اللوحي وAndroid Go وChromeOS
TensorFlow Lite Java API لخدمة Google Play Services `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 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 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