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

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

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

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

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

تعريف الموارد المرتبطة بخدمات Google Play

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

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

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

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

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.0.1'
}

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

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

كما هو موضّح في نظرة عامة على خدمات Google Play، تتلقّى "خدمات Google Play" التحديثات التلقائية على الإصدار 4.4 من نظام التشغيل Android (المستوى 19 من واجهة برمجة التطبيقات) والإصدارات الأحدث من خلال تطبيق "متجر Google Play". ومع ذلك، لا تتضمّن خدمات Google Play أجهزة 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:22.1.0`	هاتف، جهاز لوحي
المعرِّف الإعلاني على Android (AAID) `com.google.android.gms:play-services-ads-identifier:18.0.1`	هاتف، جهاز لوحي، Android TV، نظام التشغيل Chrome
الإصدار البسيط من "إعلانات Google" للأجهزة الجوّالة `com.google.android.gms:play-services-ads-lite:22.1.0`	هاتف، جهاز لوحي
إعلانات البحث المخصّص (CSA) من "AdSense للبحث" `com.google.android.gms:play-services-afs-native:19.0.3`	هاتف، جهاز لوحي، ChromeOS
حزمة تطوير البرامج (SDK) لخدمات "إحصاءات Google" لنظام التشغيل Android `com.google.android.gms:play-services-analytics:18.0.2`	متوقّف نهائيًا: استخدِم إحصاءات Google لبرنامج Firebase بدلاً من ذلك.
فهرس التطبيق `com.google.android.gms:play-services-appindex:16.1.0`	هاتف، جهاز لوحي، Android TV
رقم تعريف مجموعة تطبيقات Android `com.google.android.gms:play-services-appset:16.0.2`	هاتف، جهاز لوحي، Android TV، نظام التشغيل Chrome
تسجيل الدخول بحساب Google لأجهزة Android `com.google.android.gms:play-services-auth:20.5.0`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go، نظام التشغيل Chrome
SMS Recovery API `com.google.android.gms:play-services-auth-api-phone:18.0.1`	هاتف، جهاز لوحي، Android Go
حظر واجهة برمجة تطبيقات المتجر (بما في ذلك وحدة تخزين بيانات اعتماد المستخدم) `com.google.android.gms:play-services-auth-blockstore:16.2.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
Google Awareness API `com.google.android.gms:play-services-awareness:19.0.1`	هاتف، جهاز لوحي، تلقائي، Android Go، نظام التشغيل Chrome
فئات الخدمات `com.google.android.gms:play-services-base:18.2.0`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go، نظام التشغيل Chrome، Wear OS
اختبار التزوير على فئات المرافق `com.google.android.gms:play-services-base-testing:16.0.0`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go، نظام التشغيل Chrome، Wear OS
المزيد من فئات الخدمات المساعدة `com.google.android.gms:play-services-basement:18.2.0`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go، نظام التشغيل Chrome، Wear OS
Google Cast `com.google.android.gms:play-services-cast:21.3.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
إطار عمل تطبيق Google Cast (CAF) `com.google.android.gms:play-services-cast-framework:21.3.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
أجهزة استقبال Android TV `com.google.android.gms:play-services-cast-tv:21.0.0`	Android TV
ماسح الرموز من Google `com.google.android.gms:play-services-code-scanner:16.0.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
حزمة شبكة Chromium (Cronet) `com.google.android.gms:play-services-cronet:18.0.1`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go، نظام التشغيل Chrome، Wear OS
التفاعلات بين الأجهزة (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta01`	هاتف، جهاز لوحي، Android Go
المصادقة السريعة للكيان على الإنترنت (FIDO) `com.google.android.gms:play-services-fido:20.0.1`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS تتوفر هذه الميزة على الأجهزة التي تعمل بالإصدار 7.0 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 24) أو الإصدارات الأحدث.
Google Fit API لأجهزة Android `com.google.android.gms:play-services-fitness:21.1.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome، Wear OS
الإصدار 2 من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games-v2:17.0.0`	هاتف، جهاز لوحي، Android TV، Android Go، نظام التشغيل Chrome
الإصدار الثاني من حزمة تطوير البرامج (SDK) الأصلية للإصدار 2 من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1`	هاتف، جهاز لوحي، Android TV، Android Go، نظام التشغيل Chrome
الإصدار 1 من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games:23.1.0`	هاتف، جهاز لوحي، Android TV، Android Go، نظام التشغيل Chrome
Matter API `com.google.android.gms:play-services-home:16.0.0`	هاتف، جهاز لوحي
تطبيقات Google Play الفورية `com.google.android.gms:play-services-instantapps:18.0.1`	الهاتف والجهاز اللوحي وAndroid TV وAndroid Go ونظام التشغيل Chrome تتوفر هذه الميزة على الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 21) أو الإصدارات الأحدث.
موفِّر الموقع المدمج في نظام Android (بما في ذلك التعرُّف على الأنشطة ووضع الحدود الجغرافية) `com.google.android.gms:play-services-location:21.0.1`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go، نظام التشغيل Chrome، Wear OS
حزمة تطوير البرامج (SDK) في "خرائط Google" لأجهزة Android `com.google.android.gms:play-services-maps:18.1.0`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go، نظام التشغيل Chrome، Wear OS
مسح الرموز الشريطية باستخدام حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-barcode-scanning:18.2.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
التعرّف على الوجوه في مجموعة تعلّم الآلة `com.google.android.gms:play-services-mlkit-face-detection:17.1.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
تصنيف الصور في حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-image-labeling:16.0.8`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
تصنيف مخصّص لصورة حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
التعرُّف على اللغة في حزمة تعلُّم الآلة `com.google.android.gms:play-services-mlkit-language-id:17.0.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
الرد السريع من خلال حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
التعرّف على النص في حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition:19.0.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
التعرّف على النص في حزمة تعلّم الآلة للغة الصينية `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
التعرّف على النص في حزمة تعلّم الآلة للغة الديفاناغاري `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
التعرّف على النص في حزمة تعلّم الآلة للّغة اليابانية `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
التعرُّف على نص حزمة تعلّم الآلة للغة الكورية `com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
استكشاف الأجهزة المجاورة والاتصال بها `com.google.android.gms:play-services-nearby:18.5.0`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go
عرض تراخيص البرامج المفتوحة المصدر `com.google.android.gms:play-services-oss-licenses:17.0.1`	هاتف أو جهاز لوحي أو Android TV أو Auto أو Android Go أو ChromeOS متاح على الأجهزة التي تعمل بنظام التشغيل Android 5.0 (مستوى واجهة برمجة التطبيقات 21) أو إصدار أحدث.
فحص جودة قفل الشاشة `com.google.android.gms:play-services-password-complexity:18.0.1`	هاتف وجهاز لوحي وAndroid Go وChromeOS وWear OS تتوفر هذه الميزة على الأجهزة التي تعمل بنظام التشغيل Android 4.4 (مستوى واجهة برمجة التطبيقات 19) إلى Android 9 (مستوى واجهة برمجة التطبيقات 28).
Google Pay for Passes `com.google.android.gms:play-services-pay:16.1.0`	هاتف أو جهاز لوحي أو Android Go أو نظام التشغيل ChromeOS تتوفر هذه الميزة في الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 20) أو الإصدارات الأحدث.
reCAPTCHA Enterprise لقياس حالة استخدام التطبيقات `com.google.android.gms:play-services-recaptcha:17.0.1`	هاتف، جهاز لوحي، Android TV، Android Go، نظام التشغيل Chrome
SafetyNet API (بما في ذلك مصادقة الجهاز والتصفّح الآمن وCAPTCHA وإثبات ملكية التطبيق) `com.google.android.gms:play-services-safetynet:18.0.1`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go، نظام التشغيل Chrome
إدارة العلامات من Google `com.google.android.gms:play-services-tagmanager:18.0.2`	هاتف، جهاز لوحي، Android TV، Android Go، نظام التشغيل Chrome
Tasks API على Android `com.google.android.gms:play-services-tasks:18.0.2`	هاتف، جهاز لوحي، Android TV، تلقائي، Android Go، نظام التشغيل Chrome، Wear OS
خدمة Acceleration لأجهزة Android `com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
واجهة برمجة تطبيقات TensorFlow Lite المفوَّضة لوحدة معالجة الرسومات لخدمات Google Play `com.google.android.gms:play-services-tflite-gpu:16.2.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
TensorFlow Lite Java API لخدمات Google Play `com.google.android.gms:play-services-tflite-java:16.1.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
TensorFlow Lite Support API لخدمات Google Play `com.google.android.gms:play-services-tflite-support:16.1.0`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
واجهة برمجة تطبيقات شبكة Thread `com.google.android.gms:play-services-threadnetwork:16.0.0`	هاتف، جهاز لوحي
الرؤية الخاصة بالأجهزة الجوّالة `com.google.android.gms:play-services-vision:20.1.3`	هاتف، جهاز لوحي، Android Go، نظام التشغيل Chrome
Google Pay للدفع على أجهزة Android `com.google.android.gms:play-services-wallet:19.2.0-beta01`	هاتف، جهاز لوحي، تلقائي، Android Go، نظام التشغيل Chrome، Wear OS
واجهة برمجة التطبيقات لطبقة البيانات القابلة للارتداء `com.google.android.gms:play-services-wearable:18.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، تلقائي، Android Go، نظام التشغيل Chrome، Wear OS