تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

الإعلان عن البرامج الاعتمادية لـ "خدمات 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.4.0'
}

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

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

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

للتحقّق من توفّر "خدمات Google Play" على الجهاز، استخدِم طريقة isGooglePlayServicesAvailable().

لبدء اتصال بـ "خدمات Google Play" أو لمعرفة كيفية رصد ما إذا كان إصدار "خدمات Google Play" المثبَّت يتيح استخدام واجهة برمجة تطبيقات معيّنة، اطّلِع على دليل الوصول إلى واجهات برمجة تطبيقات Google.

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

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

**الجدول 1.** البرامج الاعتمادية لـ "خدمات Google Play" التي يجب تضمينها في تطبيقات Android
حالة الاستخدام واسم البرنامج الاعتمادي	الأجهزة المعتمدة
إعلانات Google على الأجهزة الجوّالة `com.google.android.gms:play-services-ads:25.4.0`	هاتف، جهاز لوحي
المعرِّف الإعلاني على Android‏ (AAID) `com.google.android.gms:play-services-ads-identifier:18.3.0`	هاتف، جهاز لوحي، Android TV، ChromeOS
الإصدار الخفيف من "إعلانات Google على الأجهزة الجوّالة" `com.google.android.gms:play-services-ads-lite:25.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 TV، ChromeOS
تسجيل الدخول باستخدام حساب Google على Android `com.google.android.gms:play-services-auth:21.6.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS
واجهة برمجة التطبيقات SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.3.1`	هاتف، جهاز لوحي، 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:20.0.0`	هاتف، جهاز لوحي، Auto، Android Go، ChromeOS
فئات الأدوات `com.google.android.gms:play-services-base:18.10.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
اختبار النماذج الوهمية لفئات الأدوات `com.google.android.gms:play-services-base-testing:16.2.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
المزيد من فئات الأدوات `com.google.android.gms:play-services-basement:18.10.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
تحسين الإضاءة المنخفضة في الكاميرا `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta08`	هاتف، جهاز لوحي
Google Cast `com.google.android.gms:play-services-cast:22.3.1`	هاتف، جهاز لوحي، Android Go، ChromeOS
إطار عمل تطبيقات Google Cast `com.google.android.gms:play-services-cast-framework:22.3.1`	هاتف، جهاز لوحي، 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.1`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
التفاعلات بين الأجهزة (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta02`	هاتف، جهاز لوحي، Android Go
حزمة Key Verifier SDK `com.google.android.gms:contactkeys:16.0.0`	هاتف، جهاز لوحي
المصادقة على الهوية السريعة على الإنترنت (FIDO) `com.google.android.gms:play-services-fido:21.3.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.3.0`	هاتف، جهاز لوحي، Android Go، ChromeOS، Wear OS
الحماية من الاحتيال `com.google.android.gms:play-services-fraudprotect:16.0.1`	هاتف، جهاز لوحي، Android Go
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games-v2:21.0.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
الإصدار الثاني من حزمة SDK الأصلية للغة C من "خدمات ألعاب 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:25.0.0`	تمّت إزالة هذا العمود. استخدِم الإصدار الثاني من "خدمات ألعاب Google Play" بدلاً من ذلك.
واجهة برمجة التطبيقات Matter API `com.google.android.gms:play-services-home:16.0.0`	هاتف، جهاز لوحي
تطبيقات Google Play الفورية `com.google.android.gms:play-services-instantapps:18.2.0`	تمّت إزالة هذا العمود. مزيد من المعلومات عن تطبيقات Google Play الفورية
خدمات الموقع الجغرافي لنظام التشغيل Android `com.google.android.gms:play-services-location:21.4.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android `com.google.android.gms:play-services-maps:20.0.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
حزمة Google Maps 3D SDK لنظام التشغيل Android `com.google.android.gms:play-services-maps3d:0.2.0`	هاتف، جهاز لوحي
تحسين تأثيرات الوسائط `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta07`	هاتف، جهاز لوحي
مسح الرموز الشريطية ضوئيًا باستخدام حزمة تعلّم الآلة `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`	هاتف، جهاز لوحي، 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.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
التعرّف على النص باللغة اليابانية باستخدام حزمة تعلّم الآلة `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1`	هاتف، جهاز لوحي، Android Go، ChromeOS
التعرّف على النص باللغة الكورية باستخدام حزمة تعلّم الآلة `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.5.1`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS متوافقة مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (مستوى واجهة برمجة التطبيقات 21) أو إصدار أحدث
مكتبات الوصول الآلي (PAL) `com.google.android.gms:play-services-pal:23.0.0`	هاتف، جهاز لوحي، Android TV متوافقة مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 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 Passes) `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 Tag Manager `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.4.1`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
خدمة التسريع لنظام التشغيل Android `com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02`	هاتف، جهاز لوحي، Android Go، ChromeOS
واجهة برمجة التطبيقات TensorFlow Lite GPU Delegate API لـ "خدمات Google Play" `com.google.android.gms:play-services-tflite-gpu:16.5.0`	هاتف، جهاز لوحي، Android Go، ChromeOS
واجهة برمجة التطبيقات TensorFlow Lite Java API لـ "خدمات Google Play" `com.google.android.gms:play-services-tflite-java:16.5.0`	هاتف، جهاز لوحي، Android Go، ChromeOS
واجهة برمجة التطبيقات TensorFlow Lite Support API لـ "خدمات Google Play" `com.google.android.gms:play-services-tflite-support:16.5.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`	هاتف، جهاز لوحي، Auto، 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:20.0.0`	هاتف، جهاز لوحي، Auto، Android Go، ChromeOS، Wear OS
واجهة برمجة التطبيقات Wearable Data Layer API `com.google.android.gms:play-services-wearable:20.0.1`	هاتف، جهاز لوحي، Wear OS

مكوّنات Gradle الإضافية

تتضمّن "خدمات Google Play" أيضًا عدة مكوّنات Gradle الإضافية، كما هو موضّح في الجدول التالي. يُرجى العِلم أنّ الأزرار التي تظهر قبل الجدول السابق لا تغيِّر المعلومات التي تظهر في هذا الجدول.

**الجدول 2.** قائمة بمكوّنات Gradle الإضافية المضمّنة في "خدمات Google Play" services
حالة الاستخدام واسم مكوّن Gradle الإضافي	الأجهزة المعتمدة
عرض تراخيص البرامج المفتوحة المصدر `com.google.android.gms:oss-licenses-plugin:0.13.0`	هاتف، جهاز لوحي، ChromeOS
التحقّق الدقيق من الإصدار `com.google.android.gms:strict-version-matcher-plugin:1.2.4`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS