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

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

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

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

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

للتحقّق من توفّر "خدمات 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.5.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.0.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:22.0.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.11.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.12.0`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
تحسين الإضاءة المنخفضة في الكاميرا `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09`	هاتف أو جهاز لوحي
Google Cast `com.google.android.gms:play-services-cast:22.3.1`	هاتف وجهاز لوحي وAndroid Go وChromeOS
إطار عمل تطبيقات Google Cast‏ (CAF) `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 متوافق مع الأجهزة التي تعمل بالإصدار 7.0 من نظام التشغيل Android (المستوى 24 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
Google Fit API لنظام التشغيل Android وRecording API على الأجهزة الجوّالة (لبيانات اللياقة البدنية الخاصة بالمستخدم) `com.google.android.gms:play-services-fitness:21.3.0`	هاتف، جهاز لوحي، Android Go، ChromeOS، Wear OS
‫Fraud Protect `com.google.android.gms:play-services-fraudprotect:16.0.1`	الهاتف والجهاز اللوحي وAndroid Go
الإصدار 2 من "خدمات ألعاب Google Play" على Android `com.google.android.gms:play-services-games-v2:22.1.0`	هاتف أو جهاز لوحي أو Android TV أو Android Go أو ChromeOS
حزمة تطوير البرامج (SDK) للإصدار الثاني من "خدمات ألعاب Google Play" بلغة C الأصلية لنظام التشغيل 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`	تمّت إزالة هذا العمود. يمكنك بدلاً من ذلك استخدام الإصدار 2 من "خدمات ألعاب 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" الثلاثية الأبعاد لأجهزة Android `com.google.android.gms:play-services-maps3d:0.2.2`	هاتف أو جهاز لوحي
تحسين تأثير الوسائط `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08`	هاتف أو جهاز لوحي
Media Effect Studio Sound `com.google.android.gms:play-services-media-effect-studiosound:16.0.0-beta01`	هاتف أو جهاز لوحي
مسح الرموز الشريطية باستخدام حزمة تعلّم الآلة `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.5.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go
عرض تراخيص البرامج المفتوحة المصدر `com.google.android.gms:play-services-oss-licenses:17.5.2`	الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS متوافق مع الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
مكتبات الوصول الآلي (PAL) `com.google.android.gms:play-services-pal:23.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 متوافق مع الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 20 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
‫reCAPTCHA Enterprise لأدوات قياس أداء التطبيقات `com.google.android.gms:play-services-recaptcha:17.1.0`	هاتف أو جهاز لوحي أو Android TV أو Android Go أو ChromeOS
Remote Gestures API `com.google.android.gms:play-services-remotegestures:16.0.0`	هاتف أو جهاز لوحي
الإصدار 5 من "التصفّح الآمن" `com.google.android.gms:play-services-safebrowsing:16.0.0`	هاتف وجهاز لوحي وAndroid TV وAuto و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
واجهة برمجة تطبيقات Java في TensorFlow Lite لخدمات 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`	الهاتف والجهاز اللوحي وAndroid 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"
حالة الاستخدام واسم المكوّن الإضافي لنظام 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