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

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

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

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

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

اعلام وابستگی‌ها برای «خدمات 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 `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 `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.1.0`	تلفن، رایانه لوحی، Android TV،‏ Auto،‏ Android Go،‏ ChromeOS،‏ Wear OS
کیت توسعه نرم‌افزار سه‌بعدی Google Maps برای 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`	تلفن، رایانه لوحی
اسکن رمزینه 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 4.4 (سطح میانای برنامه‌سازی کاربردی ۱۹) تا Android 9 (سطح میانای برنامه‌سازی کاربردی ۲۸) دارند پشتیبانی می‌شود.
کیف پول Google (قبلاً Google Pay برای مجوزها) `com.google.android.gms:play-services-pay:16.5.0`	تلفن، رایانه لوحی، Android Go،‏ ChromeOS در دستگاه‌های دارای Android نسخه ۵.۰ (سطح میانای برنامه‌سازی کاربردی ۲۰) یا بالاتر پشتیبانی می‌شود.
‫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 APIs (شامل مرور ایمن و درستی‌سنجی برنامه‌ها) `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`	تلفن، رایانه لوحی، خودرو، 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