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

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

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

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

دستگاه Android سازگاری که Android نسخه ۷.۰ (سطح میانای برنامه‌سازی کاربردی ۲۴) یا بالاتر را اجرا می‌کند و برنامه «فروشگاه 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 API یا فعال کردن ویژگی‌هایی که به آن نیاز دارند، بررسی کنید که «خدمات 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`	تلفن، رایانه لوحی، خودرو، Android Go،‏ ChromeOS
کلاس‌های کاربردی `com.google.android.gms:play-services-base:18.11.1`	تلفن، رایانه لوحی، 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.1`	تلفن، رایانه لوحی
بهبود جلوه رسانه `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta09`	تلفن، رایانه لوحی
صدای استودیویی جلوه رسانه `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 نسخه ۵.۰ (سطح میانای برنامه‌سازی کاربردی ۲۱) یا بالاتر پشتیبانی می‌شود.
بررسی کیفیت قفل صفحه `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 نسخه ۵.۰ (سطح میانای برنامه‌سازی کاربردی ۲۰) یا بالاتر پشتیبانی می‌شود.
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`	تلفن، رایانه لوحی
مرور ایمن نسخه ۵ `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`	تلفن، رایانه لوحی، خودرو، 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