این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

سرویس های Google Play را راه اندازی کنید

To develop an app using Google Play services APIs , follow the instructions on this page to set up your project with the relevant SDKs, which are available from the Google maven repository .

برای تست برنامه خود هنگام استفاده از سرویس‌های گوگل پلی، باید از یکی از موارد زیر استفاده کنید:

یک دستگاه اندروید سازگار که اندروید ۶.۰ (سطح API ۲۳) یا بالاتر را اجرا می‌کند و برنامه فروشگاه گوگل پلی روی آن نصب شده است.
شبیه‌ساز اندروید با AVD که پلتفرم APIهای گوگل را بر اساس اندروید ۶.۰ (سطح API ۲۳) یا بالاتر اجرا می‌کند.

Declare dependencies for Google Play services

برای توسعه ویژگی‌هایی که به APIهای سرویس‌های گوگل پلی در برنامه شما وابسته هستند، مراحل زیر را انجام دهید:

فایل build.gradle را در داخل دایرکتوری ماژول برنامه خود باز کنید.
توجه: پروژه‌های اندروید استودیو شامل یک فایل build.gradle سطح بالا و یک فایل build.gradle برای هر ماژول هستند. حتماً فایل مربوط به ماژول برنامه خود را ویرایش کنید. درباره ساخت پروژه خود با Gradle بیشتر بدانید.
For each SDK that your app requires, include the dependency for that SDK. This page includes a section that lists common Google Play services dependencies for Android apps. You might also want to add Firebase to your project .
Save the changes and sync your project .

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

apply plugin: 'com.android.application'

...

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

New versions of the Google Play services SDKs with bug fixes and new features are periodically released. These updates are announced in the release notes . If your app uses a dependency that has been updated, change to the latest version in your app's dependencies to take advantage of these fixes.

Check whether Google Play services is installed

As described in the Overview of Google Play services , Google Play services is automatically updated on Android 6.0 (API level 23) and higher through the Google Play Store app. However, devices without the Google Play Store don't have Google Play services installed. If your app runs on devices without Google Play services, you should always check if Google Play services is installed before you attempt to use Google APIs or enable features that require it.

برای بررسی وجود سرویس‌های گوگل پلی روی دستگاه، از متد isGooglePlayServicesAvailable() استفاده کنید.

برای شروع اتصال به سرویس‌های گوگل پلی یا یادگیری نحوه تشخیص اینکه آیا نسخه نصب شده سرویس‌های گوگل پلی از یک API خاص پشتیبانی می‌کند یا خیر، راهنمای دسترسی به APIهای گوگل را مطالعه کنید.

Google Play services dependencies

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

**جدول 1.** وابستگی‌های سرویس‌های گوگل پلی برای گنجاندن در برنامه‌های اندروید
Use case and dependency name	دستگاه‌های پشتیبانی‌شده
Google Mobile Ads `com.google.android.gms:play-services-ads:25.3.0`	Phone, Tablet
Android Advertising ID (AAID) `com.google.android.gms:play-services-ads-identifier:18.3.0`	Phone, Tablet, Android TV, ChromeOS
Lightweight version of Google Mobile Ads `com.google.android.gms:play-services-ads-lite:25.3.0`	Phone, Tablet
AdSense for Search (AFS) Custom Search Ads (CSA) `com.google.android.gms:play-services-afs-native:19.1.0`	Phone, Tablet, ChromeOS
Google Analytics Services SDK for Android `com.google.android.gms:play-services-analytics:18.1.1`	منسوخ شده. به جای آن از گوگل آنالیتیکس برای فایربیس استفاده کنید.
App Index `com.google.android.gms:play-services-appindex:16.2.0`	Phone, Tablet, Android TV
جستجوی برنامه `com.google.android.gms:play-services-appsearch:16.0.1`	Phone, Tablet, Android TV
Android App Set ID `com.google.android.gms:play-services-appset:16.1.0`	Phone, Tablet, Android TV, ChromeOS
Google Sign-In for Android `com.google.android.gms:play-services-auth:21.6.0`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس
SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.3.0`	Phone, Tablet, Android Go
API فروشگاه بلوک (شامل ذخیره‌سازی اعتبارنامه کاربر) `com.google.android.gms:play-services-auth-blockstore:16.4.0`	Phone, Tablet, Android Go, ChromeOS
Google Awareness API `com.google.android.gms:play-services-awareness:20.0.0`	Phone, Tablet, Auto, Android Go, ChromeOS
Utility classes `com.google.android.gms:play-services-base:18.10.0`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس
Testing fakes for utility classes `com.google.android.gms:play-services-base-testing:16.2.0`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس
More utility classes `com.google.android.gms:play-services-basement:18.10.0`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس
Camera Low Light Boost `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta08`	Phone, Tablet
گوگل کست `com.google.android.gms:play-services-cast:22.3.1`	Phone, Tablet, Android Go, ChromeOS
Google Cast Application Framework (CAF) `com.google.android.gms:play-services-cast-framework:22.3.1`	Phone, Tablet, Android Go, ChromeOS
Google Code Scanner `com.google.android.gms:play-services-code-scanner:16.1.0`	Phone, Tablet, Android Go, ChromeOS
Chromium network stack (Cronet) `com.google.android.gms:play-services-cronet:18.1.1`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس
Device-to-device interactions (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta02`	Phone, Tablet, Android Go
Key Verifier SDK `com.google.android.gms:contactkeys:16.0.0`	Phone, Tablet
Fast IDentity Online (FIDO) Authentication `com.google.android.gms:play-services-fido:21.3.0`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس در دستگاه‌هایی که اندروید ۷.۰ (سطح API ۲۴) یا بالاتر را اجرا می‌کنند، پشتیبانی می‌شود.
API گوگل فیت برای اندروید و API ضبط در موبایل (برای داده‌های تناسب اندام کاربر) `com.google.android.gms:play-services-fitness:21.3.0`	Phone, Tablet, Android Go, ChromeOS, Wear OS
Fraud Protect `com.google.android.gms:play-services-fraudprotect:16.0.1`	Phone, Tablet, Android Go
Google Play Games Services v2 for Android `com.google.android.gms:play-services-games-v2:21.0.0`	Phone, Tablet, Android TV, Android Go, ChromeOS
خدمات بازی‌های گوگل پلی نسخه ۲، کیت توسعه نرم‌افزار بومی C برای اندروید `com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1`	Phone, Tablet, Android TV, Android Go, ChromeOS
Google Play Games Services v1 for Android `com.google.android.gms:play-services-games:25.0.0`	منسوخ شده. به جای آن از خدمات بازی‌های گوگل پلی نسخه ۲ استفاده کنید.
Matter API `com.google.android.gms:play-services-home:16.0.0`	Phone, Tablet
Google Play Instant `com.google.android.gms:play-services-instantapps:18.2.0`	منسوخ شده. برای اطلاعات بیشتر به Google Play Instant مراجعه کنید.
Location Services for Android `com.google.android.gms:play-services-location:21.3.0`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس
Google Maps SDK for Android `com.google.android.gms:play-services-maps:20.0.0`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس
Google Maps 3D SDK for Android `com.google.android.gms:play-services-maps3d:0.2.0`	Phone, Tablet
Media Effect Enhancement `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta06`	Phone, Tablet
ML Kit barcode scanning `com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1`	Phone, Tablet, Android Go, ChromeOS
ML Kit document scanner `com.google.android.gms:play-services-mlkit-document-scanner:16.0.0`	Phone, Tablet, Android Go, ChromeOS
ML Kit face detection `com.google.android.gms:play-services-mlkit-face-detection:17.1.0`	Phone, Tablet, Android Go, ChromeOS
ML Kit image labeling `com.google.android.gms:play-services-mlkit-image-labeling:16.0.8`	Phone, Tablet, Android Go, ChromeOS
ML Kit image labeling custom `com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5`	Phone, Tablet, Android Go, ChromeOS
ML Kit language identification `com.google.android.gms:play-services-mlkit-language-id:17.0.0`	Phone, Tablet, Android Go, ChromeOS
ML Kit smart reply `com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1`	Phone, Tablet, Android Go, ChromeOS
ML Kit subject segmentation `com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1`	Phone, Tablet, Android Go, ChromeOS
ML Kit text recognition `com.google.android.gms:play-services-mlkit-text-recognition:19.0.1`	Phone, Tablet, Android Go, ChromeOS
ML Kit text recognition for Chinese `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1`	Phone, Tablet, Android Go, ChromeOS
ML Kit text recognition for Devanagari `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1`	Phone, Tablet, Android Go, ChromeOS
ML Kit text recognition for Japanese `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1`	Phone, Tablet, Android Go, ChromeOS
ML Kit text recognition for Korean `com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1`	Phone, Tablet, Android Go, ChromeOS
Nearby device discovery and connection `com.google.android.gms:play-services-nearby:19.3.0`	Phone, Tablet, Android TV, Auto, Android Go
Show open-source licenses `com.google.android.gms:play-services-oss-licenses:17.5.1`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس در دستگاه‌هایی که اندروید ۵.۰ (سطح API ۲۱) یا بالاتر را اجرا می‌کنند، پشتیبانی می‌شود.
Programmatic Access Libraries (PAL) `com.google.android.gms:play-services-pal:23.0.0`	Phone, Tablet, Android TV در دستگاه‌هایی که اندروید ۵.۰ (سطح API ۲۱) یا بالاتر را اجرا می‌کنند، پشتیبانی می‌شود.
Screen lock quality check `com.google.android.gms:play-services-password-complexity:18.1.0`	Phone, Tablet, Android Go, ChromeOS, Wear OS پشتیبانی شده در دستگاه‌هایی که اندروید ۴.۴ (سطح API ۱۹) تا اندروید ۹ (سطح API ۲۸) را اجرا می‌کنند.
Google Wallet (formerly Google Pay for Passes) `com.google.android.gms:play-services-pay:16.5.0`	Phone, Tablet, Android Go, ChromeOS در دستگاه‌هایی که اندروید ۵.۰ (سطح API 20) یا بالاتر را اجرا می‌کنند، پشتیبانی می‌شود.
reCAPTCHA Enterprise for app instrumentation `com.google.android.gms:play-services-recaptcha:17.1.0`	Phone, Tablet, Android TV, Android Go, ChromeOS
APIهای SafetyNet (شامل مرور ایمن و تأیید برنامه‌ها) `com.google.android.gms:play-services-safetynet:18.1.0`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس
Google Tag Manager `com.google.android.gms:play-services-tagmanager:18.3.0`	Phone, Tablet, Android TV, Android Go, ChromeOS
Tasks API on Android `com.google.android.gms:play-services-tasks:18.4.1`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس
Acceleration Service for Android `com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02`	Phone, Tablet, Android Go, ChromeOS
API نماینده پردازنده گرافیکی TensorFlow Lite برای سرویس‌های گوگل پلی `com.google.android.gms:play-services-tflite-gpu:16.5.0`	Phone, Tablet, Android Go, ChromeOS
API جاوا TensorFlow Lite برای سرویس‌های گوگل پلی `com.google.android.gms:play-services-tflite-java:16.5.0`	Phone, Tablet, Android Go, ChromeOS
پشتیبانی از API تنسورفلو لایت برای سرویس‌های گوگل پلی `com.google.android.gms:play-services-tflite-support:16.5.0`	Phone, Tablet, Android Go, ChromeOS
Thread Network API `com.google.android.gms:play-services-threadnetwork:16.3.0`	Phone, Tablet
Trusted Time API `com.google.android.gms:play-services-time:16.0.1`	Phone, Tablet, Auto, Android Go, Wear OS
Mobile Vision `com.google.android.gms:play-services-vision:20.1.3`	Phone, Tablet, Android Go, ChromeOS
Google Pay for Payments on Android `com.google.android.gms:play-services-wallet:20.0.0`	تلفن، تبلت، اتو، اندروید گو، کروم او اس، ویر او اس
Wearable Data Layer API `com.google.android.gms:play-services-wearable:20.0.1`	Phone, Tablet, Wear OS

Gradle plugins

سرویس‌های گوگل پلی همچنین شامل چندین افزونه Gradle هستند، همانطور که در جدول زیر نشان داده شده است. توجه داشته باشید که دکمه‌هایی که قبل از جدول قبلی ظاهر می‌شوند، اطلاعاتی را که در این جدول ظاهر می‌شوند تغییر نمی‌دهند.

**جدول 2.** فهرست افزونه‌های Gradle موجود در سرویس‌های Google Play
Use case and Gradle plugin name	دستگاه‌های پشتیبانی‌شده
Show open-source licenses `com.google.android.gms:oss-licenses-plugin:0.12.0`	Phone, Tablet, ChromeOS
Strict version checking `com.google.android.gms:strict-version-matcher-plugin:1.2.4`	تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس