Configurar os serviços do Google Play

Para desenvolver um app usando as APIs do Google Play Services, siga as instruções desta página para configurar seu projeto com os SDKs relevantes, que estão disponíveis no repositório Maven do Google.

Para testar o app ao usar o Google Play Services, é necessário usar uma das seguintes opções:

  • Um dispositivo Android compatível que execute o Android 6.0 (nível 23 da API) ou mais recente e tenha o app Google Play Store instalado.
  • O Android Emulator com um AVD que executa a plataforma de APIs do Google com base no Android 6.0 (nível 23 da API) ou versões mais recentes.

Declarar dependências para o Google Play Services

Para desenvolver recursos que dependem das APIs do Google Play Services no seu app, siga estas etapas:

  1. Abra o arquivo build.gradle no diretório do módulo do app.

  2. Para cada SDK exigido pelo app, inclua a dependência correspondente. Esta página inclui uma seção que lista as dependências do Google Play Services comuns para apps Android. Também é possível adicionar o Firebase ao seu projeto.

  3. Salve as mudanças e sincronize seu projeto.

O snippet a seguir mostra um exemplo de arquivo build.gradle que usa a biblioteca de localização:

apply plugin: 'com.android.application'

...

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

Novas versões dos SDKs do Google Play Services com correções de bugs e novos recursos são lançadas periodicamente. Essas atualizações são anunciadas nas notas de lançamento. Se o app usar uma dependência que foi atualizada, mude para a versão mais recente nas dependências do app para aproveitar essas correções.

Verificar se o Google Play Services está instalado

Como descrito na Visão geral do Google Play Services, o Google Play Services é atualizado automaticamente no Android 6.0 (nível 23 da API) e versões mais recentes pelo app Google Play Store. No entanto, dispositivos sem a Google Play Store não têm o Google Play Services instalado. Se o app for executado em dispositivos sem o Google Play Services, sempre verifique se ele está instalado antes de tentar usar as APIs do Google ou ativar recursos que exigem o serviço.

Para verificar a presença do Google Play Services no dispositivo, use o método isGooglePlayServicesAvailable().

Para iniciar uma conexão com o Google Play Services ou saber como detectar se a versão instalada do Google Play Services é compatível com uma API específica, leia o guia sobre Acessar APIs do Google.

Dependências do Google Play Services

A tabela a seguir lista as dependências dos Serviços do Google Play que você pode incluir no seu app Android. É possível filtrar a lista por tipo de dispositivo selecionando um dos botões e pesquisar um caso de uso ou nome de dependência específico inserindo texto na caixa que aparece depois dos botões.

Tabela 1. Dependências do Google Play Services para incluir em apps Android
Caso de uso e nome da dependência Dispositivos compatíveis
Anúncios do Google Mobile
com.google.android.gms:play-services-ads:24.4.0
Smartphone, tablet
ID de publicidade do Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.2.0
Smartphone, tablet, Android TV, ChromeOS
Versão leve do Google Mobile Ads
com.google.android.gms:play-services-ads-lite:24.3.0
Smartphone, tablet
Anúncios personalizados de pesquisa (CSA) do AdSense para pesquisas (AFS)
com.google.android.gms:play-services-afs-native:19.1.0
Smartphone, tablet, ChromeOS
SDK de serviços do Google Analytics para Android
com.google.android.gms:play-services-analytics:18.1.1
Obsoleto. Use o Google Analytics para Firebase.
Índice de apps
com.google.android.gms:play-services-appindex:16.2.0
Smartphone, tablet, Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
Smartphone, tablet, Android TV
ID do conjunto de apps Android
com.google.android.gms:play-services-appset:16.1.0
Smartphone, tablet, Android TV, ChromeOS
Login do Google para Android
com.google.android.gms:play-services-auth:21.3.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS
API SMS Retriever
com.google.android.gms:play-services-auth-api-phone:18.2.0
Smartphone, tablet, Android Go
API Block Store (inclui armazenamento de credenciais do usuário)
com.google.android.gms:play-services-auth-blockstore:16.4.0
Smartphone, tablet, Android Go, ChromeOS
API Google Awareness
com.google.android.gms:play-services-awareness:19.1.0
Smartphone, tablet, Auto, Android Go, ChromeOS
Classes de utilitários
com.google.android.gms:play-services-base:18.7.2
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Como testar fakes para classes de utilitários
com.google.android.gms:play-services-base-testing:16.1.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Mais classes de utilitários
com.google.android.gms:play-services-basement:18.7.1
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Melhoria de pouca luz da câmera
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta04
Smartphone, tablet
Google Cast
com.google.android.gms:play-services-cast:22.1.0
Smartphone, tablet, Android Go, ChromeOS
Framework de aplicativos Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:22.1.0
Smartphone, tablet, Android Go, ChromeOS
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.1.0
Smartphone, tablet, Android Go, ChromeOS
Pilha de rede do Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.1.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Interações entre dispositivos (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta02
Smartphone, tablet, Android Go
Autenticação Fast IDentity Online (FIDO)
com.google.android.gms:play-services-fido:21.2.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS

Compatível com dispositivos que executam o Android 7.0 (nível da API 24) ou versões mais recentes.
API Google Fit para Android e API Recording em dispositivos móveis (para dados de condicionamento físico do usuário)
com.google.android.gms:play-services-fitness:21.2.0
Smartphone, tablet, Android Go, ChromeOS, Wear OS
Google Play Games Services v2 para Android
com.google.android.gms:play-services-games-v2:21.0.0
Smartphone, tablet, Android TV, Android Go, ChromeOS
SDK nativo em C dos serviços relacionados a jogos do Google Play v2 para Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Smartphone, tablet, Android TV, Android Go, ChromeOS
Serviços relacionados a jogos do Google Play v1 para Android
com.google.android.gms:play-services-games:23.2.0
Smartphone, tablet, Android TV, Android Go, ChromeOS
API Matter
com.google.android.gms:play-services-home:16.0.0
Smartphone, tablet
Google Play Instant
com.google.android.gms:play-services-instantapps:18.2.0
Obsoleto. Consulte Google Play Instant para mais informações.
Serviços de localização para Android
com.google.android.gms:play-services-location:21.3.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK do Google Maps para Android
com.google.android.gms:play-services-maps:19.2.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK 3D do Google Maps para Android
com.google.android.gms:play-services-maps3d:0.0.2
Smartphone, tablet
Leitura de código de barras do Kit de ML
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
Smartphone, tablet, Android Go, ChromeOS
Leitor de documentos do Kit de ML
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
Smartphone, tablet, Android Go, ChromeOS
Detecção facial do Kit de ML
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Smartphone, tablet, Android Go, ChromeOS
Rotulagem de imagens do ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Smartphone, tablet, Android Go, ChromeOS
Personalização da rotulagem de imagens do ML Kit
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
Smartphone, tablet, Android Go, ChromeOS
Identificação de idioma do kit de ML
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Smartphone, tablet, Android Go, ChromeOS
Resposta inteligente do Kit de ML
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Smartphone, tablet, Android Go, ChromeOS
Segmentação de assunto do Kit de ML
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Smartphone, tablet, Android Go, ChromeOS
Reconhecimento de texto do Kit de ML
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
Smartphone, tablet, Android Go, ChromeOS
Reconhecimento de texto do Kit de ML para chinês
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
Smartphone, tablet, Android Go, ChromeOS
Reconhecimento de texto do Kit de ML para devanágari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
Smartphone, tablet, Android Go, ChromeOS
Reconhecimento de texto do Kit de ML para japonês
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
Smartphone, tablet, Android Go, ChromeOS
Reconhecimento de texto do Kit de ML para coreano
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1
Smartphone, tablet, Android Go, ChromeOS
Descoberta e conexão de dispositivos por perto
com.google.android.gms:play-services-nearby:19.3.0
Smartphone, tablet, Android TV, Auto, Android Go
Mostrar licenças de código aberto
com.google.android.gms:play-services-oss-licenses:17.2.1
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS
Compatível com dispositivos que executam o Android 5.0 (nível da API 21) ou versões mais recentes.
Bibliotecas de acesso programático (PAL)
com.google.android.gms:play-services-pal:22.0.0
Smartphone, tablet, Android TV
Compatível com dispositivos que executam o Android 5.0 (nível 21 da API) ou versões mais recentes.
Verificação de qualidade do bloqueio de tela
com.google.android.gms:play-services-password-complexity:18.1.0
Smartphone, tablet, Android Go, ChromeOS, Wear OS

Compatível com dispositivos que executam o Android 4.4 (nível 19 da API) ao Android 9 (nível 28 da API).
Carteira do Google (antigo Google Pay para cartões)
com.google.android.gms:play-services-pay:16.5.0
Smartphone, tablet, Android Go, ChromeOS

Compatível com dispositivos que executam o Android 5.0 (nível da API 20) ou versões mais recentes.
reCAPTCHA Enterprise para instrumentação de apps
com.google.android.gms:play-services-recaptcha:17.1.0
Smartphone, tablet, Android TV, Android Go, ChromeOS
APIs do SafetyNet (inclui navegação segura e verificação de apps)
com.google.android.gms:play-services-safetynet:18.1.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS
Gerenciador de tags do Google
com.google.android.gms:play-services-tagmanager:18.3.0
Smartphone, tablet, Android TV, Android Go, ChromeOS
API Tasks no Android
com.google.android.gms:play-services-tasks:18.3.2
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Serviço de aceleração para Android
com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01
Smartphone, tablet, Android Go, ChromeOS
API de delegado de GPU do TensorFlow Lite para o Google Play Services
com.google.android.gms:play-services-tflite-gpu:16.4.0
Smartphone, tablet, Android Go, ChromeOS
API Java do TensorFlow Lite para o Google Play Services
com.google.android.gms:play-services-tflite-java:16.4.0
Smartphone, tablet, Android Go, ChromeOS
API de suporte do TensorFlow Lite para o Google Play Services
com.google.android.gms:play-services-tflite-support:16.4.0
Smartphone, tablet, Android Go, ChromeOS
API Thread Network
com.google.android.gms:play-services-threadnetwork:16.3.0
Smartphone, tablet
API Trusted Time
com.google.android.gms:play-services-time:16.0.1
Smartphone, tablet, Auto, Android Go, Wear OS
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
Smartphone, tablet, Android Go, ChromeOS
Google Pay para pagamentos no Android
com.google.android.gms:play-services-wallet:19.4.0
Smartphone, tablet, Auto, Android Go, ChromeOS, Wear OS
API Wearable Data Layer
com.google.android.gms:play-services-wearable:19.0.0
Smartphone, tablet, Wear OS

Plug-ins do Gradle

O Google Play Services também inclui vários plug-ins do Gradle, conforme mostrado na tabela a seguir. Os botões que aparecem antes da tabela anterior não mudam as informações que aparecem nela.

Tabela 2. Lista de plug-ins do Gradle incluídos no Google Play Services
Caso de uso e nome do plug-in do Gradle Dispositivos compatíveis
Mostrar licenças de código aberto
com.google.android.gms:oss-licenses-plugin:0.10.6
Smartphone, tablet, ChromeOS
Verificação estrita de versão
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS