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 e configure seu projeto com os SDKs relevantes, disponíveis no repositório Maven do Google.

Para testar seu app ao usar o Google Play Services, use uma das seguintes opções:

  • Um dispositivo Android compatível que execute o Android 4.4 (API de nível 19) ou versão 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 4.4 (API de nível 19) 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 dentro do diretório do módulo do seu app.

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

  3. Salve as alterações e sincronize seu projeto.

O snippet a seguir mostra um exemplo de arquivo build.gradle que usa a biblioteca de locais:

apply plugin: 'com.android.application'

...

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

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 usa 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

Conforme descrito na Visão geral do Google Play Services, o Google Play Services recebe atualizações automáticas no Android 4.4 (API de nível 19) e versões mais recentes por meio do app Google Play Store. No entanto, os dispositivos Android 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, verifique se ele está instalado antes de tentar usar as APIs do Google ou ative os recursos que exigem o Google Play Services para funcionar.

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 do Google Play Services instalada é compatível com uma API específica, leia o guia sobre Como acessar APIs do Google.

Dependências do Google Play Services

A tabela a seguir lista as dependências do Google Play Services que podem ser incluídas 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 após os botões.

Tabela 1. Dependências do Google Play Services a serem incluídas em apps para Android
Nome do caso de uso e da dependência Dispositivos com suporte
Anúncios para dispositivos móveis do Google
com.google.android.gms:play-services-ads:22.1.0
Smartphone, tablet
ID de publicidade do Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
Smartphone, tablet, Android TV e ChromeOS
Versão leve dos anúncios para dispositivos móveis do Google
com.google.android.gms:play-services-ads-lite:22.1.0
Smartphone, tablet
Anúncios personalizados de pesquisa (CSA) do AdSense para pesquisas (AFS)
com.google.android.gms:play-services-afs-native:19.0.3
Smartphone, tablet, ChromeOS
SDK de serviços do Google Analytics para Android
com.google.android.gms:play-services-analytics:18.0.2
Obsoleto. Use o Google Analytics para Firebase.
Índice do app
com.google.android.gms:play-services-appindex:16.1.0
Smartphone, tablet, Android TV
ID do conjunto de apps Android
com.google.android.gms:play-services-appset:16.0.2
Smartphone, tablet, Android TV e ChromeOS
Login do Google para Android
com.google.android.gms:play-services-auth:20.5.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS
API SMS Retriever
com.google.android.gms:play-services-auth-api-phone:18.0.1
Smartphone, tablet, Android Go
API Block Store (inclui armazenamento de credenciais do usuário)
com.google.android.gms:play-services-auth-blockstore:16.2.0
Smartphone, tablet, Android Go, ChromeOS
API Google Awareness
com.google.android.gms:play-services-awareness:19.0.1
Smartphone, tablet, Android Auto, Android Go, ChromeOS
Classes de serviços públicos
com.google.android.gms:play-services-base:18.2.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Como testar falsificações para classes de utilitários
com.google.android.gms:play-services-base-testing:16.0.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Mais classes de utilitários
com.google.android.gms:play-services-basement:18.2.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.3.0
Smartphone, tablet, Android Go, ChromeOS
CAF (framework de aplicativo do Google Cast)
com.google.android.gms:play-services-cast-framework:21.3.0
Smartphone, tablet, Android Go, ChromeOS
Receptores do Android TV
com.google.android.gms:play-services-cast-tv:21.0.0
Android TV
Leitor de código do Google
com.google.android.gms:play-services-code-scanner:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Pilha de rede Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.0.1
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Interações entre dispositivos (DTDI, na sigla em inglês)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
Smartphone, tablet, Android Go
Autenticação on-line do Fast IDentity (FIDO)
com.google.android.gms:play-services-fido:20.0.1
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS

Compatível com dispositivos que executam o Android 7.0 (API de nível 24) ou versões mais recentes.
API Google Fit para Android
com.google.android.gms:play-services-fitness:21.1.0
Smartphone, tablet, Android Go, ChromeOS, Wear OS
Serviços relacionados a jogos do Google Play v2 para Android
com.google.android.gms:play-services-games-v2:17.0.0
Smartphone, tablet, Android TV, Android Go, ChromeOS
SDK nativo 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.1.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.0.1
Smartphone, tablet, Android TV, Android Go e ChromeOS

Compatível com dispositivos que executam o Android 5.0 (API de nível 21) ou versões mais recentes.
Provedor de localização combinada para Android (inclui reconhecimento de atividade e fronteira geográfica virtual)
com.google.android.gms:play-services-location:21.0.1
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK do Google Maps para Android
com.google.android.gms:play-services-maps:18.1.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Leitura do código de barras do kit de ML
com.google.android.gms:play-services-mlkit-barcode-scanning:18.2.0
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
Rotulação de imagens do kit de ML
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Smartphone, tablet, Android Go, ChromeOS
Rótulo personalizado de imagem do kit de ML
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4
Smartphone, tablet, Android Go, ChromeOS
Identificação do 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
Reconhecimento de texto por Kit de ML
com.google.android.gms:play-services-mlkit-text-recognition:19.0.0
Smartphone, tablet, Android Go, ChromeOS
Reconhecimento de texto em Kit de ML para chinês
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Reconhecimento de texto em Kit de ML para Devanagari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Reconhecimento de texto em Kit de ML para japonês
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Reconhecimento de texto em Kit de ML para coreano
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Conexão e descoberta de dispositivos por perto
com.google.android.gms:play-services-nearby:18.5.0
Smartphone, tablet, Android TV, Auto, Android Go
Mostrar licenças de código aberto
com.google.android.gms:play-services-oss-licenses:17.0.1
Smartphone, tablet, Android TV, Android Auto, Android Go e ChromeOS
Compatível com dispositivos que executam o Android 5.0 (API de nível 21) ou versões mais recentes.
Verificação de qualidade do bloqueio de tela
com.google.android.gms:play-services-password-complexity:18.0.1
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).
Google Pay for Passes
com.google.android.gms:play-services-pay:16.1.0
Smartphone, tablet, Android Go, ChromeOS

Compatível com dispositivos que executam o Android 5.0 (API de nível 20) ou versões mais recentes.
reCAPTCHA Enterprise para instrumentação do app
com.google.android.gms:play-services-recaptcha:17.0.1
Smartphone, tablet, Android TV, Android Go, ChromeOS
APIs SafetyNet (inclui atestado de dispositivo, navegação segura, reCAPTCHA e verificação de app)
com.google.android.gms:play-services-safetynet:18.0.1
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS
Gerenciador de tags do Google
com.google.android.gms:play-services-tagmanager:18.0.2
Smartphone, tablet, Android TV, Android Go, ChromeOS
API Tasks no Android
com.google.android.gms:play-services-tasks:18.0.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.0.0-beta01
Smartphone, tablet, Android Go, ChromeOS
API Delegate da GPU do TensorFlow Lite para o Google Play Services
com.google.android.gms:play-services-tflite-gpu:16.2.0
Smartphone, tablet, Android Go, ChromeOS
API TensorFlow Lite Java para Google Play Services
com.google.android.gms:play-services-tflite-java:16.1.0
Smartphone, tablet, Android Go, ChromeOS
API TensorFlow Lite Support para Google Play Services
com.google.android.gms:play-services-tflite-support:16.1.0
Smartphone, tablet, Android Go, ChromeOS
API Thread Network
com.google.android.gms:play-services-threadnetwork:16.0.0
Smartphone, tablet
Visão geral para dispositivos móveis
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.2.0-beta01
Smartphone, tablet, Android Auto, Android Go, Chrome OS, Wear OS
API Wearable Data Layer
com.google.android.gms:play-services-wearable:18.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. Observe que os botões que aparecem antes da tabela anterior não alteram 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 Gradle Dispositivos com suporte
Mostrar licenças de código aberto
com.google.android.gms:oss-licenses-plugin:0.10.6
Smartphone, tablet, ChromeOS
Verificação de versão estrita
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS