Set up Google Play services (original) (raw)

Skip to main content

• API Guides

• New Releases

• Reference

• Samples

• Support

• Downloads

• Beta

• Overview

• Setup

• Accessing APIs

• Client Authentication

• Module install APIs

• Runtime Permissions

• Tasks API

• Open Source Notices

• Prepare for Google Play data disclosure requirements

• Versioning

• Releases

• Beta Program

• SDK Getting Started Guides

  • User Experiences
    * Google Cast
    * Google Maps SDK
    * Google Pay API
    * Google Wallet
    * Google Play Games Services
    * Wear OS
    * Advanced Capabilities
    * Activity Recognition
    * Matter
    * ML Kit
    * LiteRT
    * Nearby
    * ThreadNetwork
    * Security & Privacy
    * FIDO
    * SafetyNet
    * Security Provider
    * Engagement
    * Google AdMob
    * Google Analytics for Firebase
    * Google Tag Manager
    * App Basics
    * Cronet
    * Firebase Cloud Messaging
    * Block Store
    * Google Sign-In
    * Location and Context
    * Time

Set up Google Play services

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 theGoogle maven repository.

To test your app when using Google Play services, you must use one of the following:

• A compatible Android device that runs Android 6.0 (API level 23) or higher and has the Google Play Store app installed.
• The Android emulator with anAVD that runs the Google APIs platform based on Android 6.0 (API level 23) or higher.

Declare dependencies for Google Play services

To develop features that depend on the Google Play services APIs in your app, complete the following steps:

1. Open the build.gradle file inside your app's module directory.
2. 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.
3. Save the changes and sync your project.

The following snippet shows an example build.gradle file that uses the location library:

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.

To check for the presence of Google Play services on the device, use theisGooglePlayServicesAvailable()method.

To then begin a connection to Google Play services, or learn how to detect whether the version of Google Play services installed supports a specific API, read the guide on Accessing Google APIs.

Google Play services dependencies

The following table lists the dependencies for Google Play services that you can include in your Android app. You can filter the list by device type by selecting one of the buttons, and you can search for a specific use case or dependency name by entering text into the box that appears after the buttons.

Table 1. Google Play services dependencies to include in Android apps

Gradle plugins

Google Play services also includes several Gradle plugins, as shown in the following table. Note that the buttons that appear before the previous table don't change the information that appears in this table.

Table 2. List of Gradle plugins included in Google Play services

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-04-09 UTC.