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

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

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

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

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

توضيح الموارد الاعتمادية لخدمات 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 5.0 (المستوى 21 من واجهة برمجة التطبيقات) والإصدارات الأحدث من خلال تطبيق "متجر Google Play"، لكنّ خدمات Google Play لا تكون مثبّتة على أجهزة Android التي لا تتضمّن "متجر Google Play". إذا كان تطبيقك يعمل على أجهزة لا تتوفّر فيها خدمات Google Play، ننصحك بالتحقق ممّا إذا كانت خدمات Google Play مثبّتة على الجهاز قبل محاولة استخدام Google APIs، أو تفعيل ميزات في تطبيقك تتطلّب عمل خدمات 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.1.0`	هاتف، جهاز لوحي
المعرّف الإعلاني على Android (AAID) `com.google.android.gms:play-services-ads-identifier:18.1.0`	الهاتف والجهاز اللوحي وAndroid TV وChromeOS
الإصدار الخفيف من "إعلانات Google على الأجهزة الجوّالة" `com.google.android.gms:play-services-ads-lite:23.1.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.0`	تمّت إزالة هذا العمود. استخدِم إحصاءات Google لبرنامج Firebase بدلاً منه.
فهرس التطبيقات `com.google.android.gms:play-services-appindex:16.2.0`	الهاتف والجهاز اللوحي وAndroid TV
AppSearch `com.google.android.gms:play-services-appsearch:16.0.0`	الهاتف والجهاز اللوحي و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.2.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 (بما في ذلك وحدة تخزين بيانات اعتماد المستخدم) `com.google.android.gms:play-services-auth-blockstore:16.2.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.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.4.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
Google Cast `com.google.android.gms:play-services-cast:21.5.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
إطار عمل تطبيق Google Cast (CAF) `com.google.android.gms:play-services-cast-framework:21.5.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
أجهزة استقبال Android TV `com.google.android.gms:play-services-cast-tv:21.1.0`	Android TV
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-beta01`	الهاتف، الجهاز اللوحي، Android Go
مصادقة Fast IDentity على الإنترنت (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
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games-v2:20.1.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
الإصدار الثاني من حزمة تطوير البرامج (SDK) الأصلية لـ "خدمات ألعاب 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: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" لتطبيقات Android `com.google.android.gms:play-services-maps:18.2.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
مسح الرمز الشريطي لحزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
الماسح الضوئي للمستندات في حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1`	هاتف وجهاز لوحي و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.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرُّف على النص في مجموعة أدوات تعلُّم الآلة باللغة الصينية `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرّف على النص في لغتَي الديفاناغارية من خلال تعلّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرُّف على النص في مجموعة أدوات تعلُّم الآلة للّغة اليابانية `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرّف على النص في ML Kit باللغة الكورية `com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0`	هاتف وجهاز لوحي و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 متوافق مع الأجهزة التي تعمل بالإصدار 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 for Pass) `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 (تشمل المصادقة على الجهاز والتصفّح الآمن و 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.0`	هاتف، جهاز لوحي، 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.0.0-beta01`	هاتف وجهاز لوحي وAndroid Go وChromeOS
TensorFlow Lite GPU Delegate API لخدمات Google Play `com.google.android.gms:play-services-tflite-gpu:16.2.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
TensorFlow Lite Java API لخدمات Google Play `com.google.android.gms:play-services-tflite-java:16.2.0-beta02`	هاتف وجهاز لوحي وAndroid Go وChromeOS
TensorFlow Lite Support API لخدمات Google Play `com.google.android.gms:play-services-tflite-support:16.1.0`	هاتف وجهاز لوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات Thread Network `com.google.android.gms:play-services-threadnetwork:16.0.1`	هاتف، جهاز لوحي
الرؤية على الأجهزة الجوّالة `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`	هاتف، جهاز لوحي، Auto، Android Go، ChromeOS، Wear OS
Wearable Data Layer API `com.google.android.gms:play-services-wearable:18.2.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