‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

راه‌اندازی «خدمات Google Play»

برای توسعه دادن برنامه بااستفاده از خدمات Google Play واسط برنامه‌سازی کاربردی، دستورالعمل‌های این صفحه را برای راه‌اندازی پروژه خود با کیت‌های توسعه نرم‌افزار مربوطه که در مخزن Google maven دردسترس هستند دنبال کنید.

برای آزمایش کردن برنامه‌تان هنگام استفاده از خدمات Google Play، باید از یکی از موارد زیر استفاده کنید:

دستگاه Android سازگاری که Android نسخه ۷.۰ (سطح میانای برنامه‌سازی کاربردی ۲۴) یا بالاتر را اجرا می‌کند و برنامه «فروشگاه Google Play» در آن نصب شده است.
شبیه‌ساز Android با AVD که پلاتفرم Google APIs را براساس Android نسخه ۷.۰ (سطح API 24) یا بالاتر اجرا می‌کند.

اعلام وابستگی‌ها برای «خدمات Google Play»

برای توسعه ویژگی‌هایی که در برنامه‌تان به میانای برنامه‌سازی کاربردی خدمات Google Play وابسته هستند، مراحل زیر را تکمیل کنید:

فایل build.gradle را در دایرکتوری واحد برنامه باز کنید.

توجه: پروژه‌های Android Studio حاوی فایل build.gradle سطح بالا و فایل build.gradle برای هر واحد هستند. حتماً فایل را برای واحد برنامه خود ویرایش کنید. درباره ساختن پروژه با Gradle بیشتر بدانید.
برای هر کیت توسعه نرم‌افزاری که برنامه‌تان به آن نیاز دارد، وابستگی آن کیت توسعه نرم‌افزار را اضافه کنید. این صفحه شامل بخشی است که وابستگی‌های خدمات Google Play رایج برای برنامه‌های Android را فهرست می‌کند. همچنین ممکن است بخواهید Firebase را به پروژه خود اضافه کنید.
تغییرات را ذخیره کنید و پروژه‌تان را همگام‌سازی کنید.

تکه‌کد زیر نمونه‌ای از فایل build.gradle را نشان می‌دهد که از کتابخانه مکان استفاده می‌کند:

apply plugin: 'com.android.application'

...

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

نسخه‌های جدید کیت‌های توسعه نرم‌افزار «خدمات Google Play» با رفع اشکال و ویژگی‌های جدید به‌طور دوره‌ای منتشر می‌شوند. این به‌روزرسانی‌ها در یادداشت‌های انتشار اعلام می‌شوند. اگر برنامه‌تان از وابستگی‌ای استفاده می‌کند که به‌روز شده است، برای بهره‌مندی از این اصلاحات، به جدیدترین نسخه در وابستگی‌های برنامه‌تان بروید.

بررسی کنید آیا «خدمات Google Play» نصب شده است یا نه

همان‌طور که در نمای کلی خدمات Google Play توضیح داده شده است، «خدمات Google Play» به‌طور خودکار در Android نسخه ۷.۰ (سطح API‏ ۲۴) و بالاتر ازطریق برنامه «فروشگاه Google Play» به‌روزرسانی می‌شود. بااین‌حال، دستگاه‌های فاقد «فروشگاه Google Play» «خدمات Google Play» را نصب ندارند. اگر برنامه شما در دستگاه‌هایی که «خدمات Google Play» ندارند اجرا می‌شود، باید همیشه قبل‌از تلاش برای استفاده از «میاناهای برنامه‌سازی کاربردی Google» یا فعال کردن ویژگی‌هایی که به آن نیاز دارند، بررسی کنید که «خدمات Google Play» نصب شده است یا نه.

برای بررسی وجود «خدمات Google Play» در دستگاه، از روش isGooglePlayServicesAvailable() استفاده کنید.

برای شروع اتصال به «خدمات Google Play» یا آشنایی با نحوه تشخیص اینکه نسخه نصب‌شده «خدمات Google Play» از میانای برنامه کاربردی خاصی پشتیبانی می‌کند یا نه، راهنمای دسترسی به «میاناهای برنامه کاربردی Google» را بخوانید.

وابستگی‌های «خدمات Google Play»

جدول زیر وابستگی‌های «سرویس‌های Google Play» را فهرست می‌کند که می‌توانید در برنامه Android خود بگنجانید. با انتخاب یکی از دکمه‌ها می‌توانید فهرست را براساس نوع دستگاه فیلتر کنید، و با وارد کردن نوشتار در چارگوشی که پس‌از دکمه‌ها ظاهر می‌شود می‌توانید نام وابستگی یا مورد استفاده خاصی را جستجو کنید.

**جدول ۱.** وابستگی‌های «خدمات Google Play» برای افزودن به برنامه‌های Android
نام کاربرد و وابستگی	دستگاه‌های پشتیبانی‌شده
Google Mobile Ads `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 Mobile Ads `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
کیت توسعه نرم‌افزار سرویس‌های Google Analytics برای Android `com.google.android.gms:play-services-analytics:18.1.1`	منسوخ‌شده. به‌جای آن از Google Analytics برای 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 (کدخوان 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
کیت توسعه نرم‌افزار «درستی‌سنج کلید» `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 نسخه ۷.۰ (سطح API‏ ۲۴) یا بالاتر پشتیبانی می‌شود.
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
کیت توسعه نرم‌افزار 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 Instant `com.google.android.gms:play-services-instantapps:18.2.0`	منسوخ‌شده. برای اطلاعات بیشتر، Google Play Instant را ببینید.
خدمات مکان برای Android `com.google.android.gms:play-services-location:21.4.0`	تلفن، رایانه لوحی، Android TV،‏ Auto،‏ Android Go،‏ ChromeOS،‏ Wear OS
کیت توسعه نرم‌افزار Google Maps برای Android `com.google.android.gms:play-services-maps:20.0.0`	تلفن، رایانه لوحی، Android TV،‏ Auto،‏ Android Go،‏ ChromeOS،‏ Wear OS
کیت توسعه نرم‌افزار سه‌بعدی Google Maps برای Android `com.google.android.gms:play-services-maps3d:0.2.2`	تلفن، رایانه لوحی
بهبود جلوه رسانه `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`	تلفن، رایانه لوحی
اسکن رمزینه ML Kit `com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
اسکنر سند ML Kit `com.google.android.gms:play-services-mlkit-document-scanner:16.0.0`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
تشخیص چهره ML Kit `com.google.android.gms:play-services-mlkit-face-detection:17.1.0`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
برچسب‌گذاری تصویر ML Kit `com.google.android.gms:play-services-mlkit-image-labeling:16.0.8`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
سفارشی‌سازی برچسب‌گذاری تصویر ML Kit `com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
شناسایی زبان ML Kit `com.google.android.gms:play-services-mlkit-language-id:17.0.0`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
پاسخ هوشمند ML Kit `com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
بخش‌بندی موضوع ML Kit `com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
تشخیص نوشتار ML Kit `com.google.android.gms:play-services-mlkit-text-recognition:19.0.1`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
تشخیص نوشتار ML Kit برای زبان چینی `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
تشخیص نوشتار ML Kit برای دیواناگری `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
تشخیص نوشتار ML Kit برای زبان ژاپنی `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS
تشخیص نوشتار ML Kit برای زبان کره‌ای `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 در دستگاه‌های دارای Android نسخه ۵.۰ (سطح میانای برنامه‌سازی کاربردی ۲۱) یا بالاتر پشتیبانی می‌شود.
کتابخانه‌های دسترسی برنامه‌ریزی‌شده (PAL) `com.google.android.gms:play-services-pal:23.0.0`	تلفن، رایانه لوحی، Android TV در دستگاه‌های دارای Android 5.0 (سطح میانای برنامه‌سازی کاربردی ۲۱) یا بالاتر پشتیبانی می‌شود.
بررسی کیفیت قفل صفحه `com.google.android.gms:play-services-password-complexity:18.1.0`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS،‏ Wear OS در دستگاه‌هایی که Android نسخه ۴.۴ (سطح API‏ ۱۹) تا Android نسخه ۹ (سطح API‏ ۲۸) را اجرا می‌کنند پشتیبانی می‌شود.
کیف پول Google (قبلاً Google Pay برای مجوزها) `com.google.android.gms:play-services-pay:16.5.0`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS در دستگاه‌های دارای Android 5.0 (سطح میانای برنامه‌سازی کاربردی ۲۰) یا بالاتر پشتیبانی می‌شود.
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`	تلفن، رایانه لوحی
مرور ایمن v5 `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 `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 برای خدمات 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 است، همان‌طور که در جدول زیر نشان داده شده است. توجه داشته باشید که دکمه‌هایی که قبل‌از جدول قبلی ظاهر می‌شوند اطلاعاتی را که در این جدول ظاهر می‌شود تغییر نمی‌دهند.

**جدول ۲.** فهرست افزایه‌های 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