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

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

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

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

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

للتحقّق من توفّر "خدمات 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: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 `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`	هاتف، جهاز لوحي
المصادقة باستخدام Fast IDentity Online‏ (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
‫الحماية من الاحتيال `com.google.android.gms:play-services-fraudprotect:16.0.1`	هاتف، جهاز لوحي، Android Go
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games-v2:22.1.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
الإصدار الثاني من "خدمات ألعاب Google Play" لحزمة SDK الأصلية بلغة 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`	تم إيقاف هذه الخدمة نهائيًا. استخدِم الإصدار الثاني من "خدمات ألعاب 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.1.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
حزمة تطوير البرامج (SDK) لخرائط Google الثلاثية الأبعاد لنظام التشغيل Android `com.google.android.gms:play-services-maps3d:16.0.0`	هاتف، جهاز لوحي
تحسين تأثيرات الوسائط `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08`	هاتف، جهاز لوحي
تأثيرات الوسائط: مُحسِّن الصوت الذكي `com.google.android.gms:play-services-media-effect-studiosound:16.0.0-beta02`	هاتف، جهاز لوحي
حزمة تعلّم الآلة: مسح الرموز الشريطية ضوئيًا `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.1`	هاتف، جهاز لوحي، 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 متوافقة مع الأجهزة التي تعمل بالإصدار 4.4 من Android (مستوى واجهة برمجة التطبيقات 19) إلى الإصدار 9 من Android (مستوى واجهة برمجة التطبيقات 28)
محفظة Google (المعروفة سابقًا باسم Google Pay for Passes) `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
‫Acceleration Service لنظام التشغيل 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
‫واجهة برمجة تطبيقات طبقة بيانات الأجهزة القابلة للارتداء `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