Configurar os serviços do Google Play

Stay organized with collections Save and categorize content based on your preferences.

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 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ões mais recentes 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ão mais recente.

Declarar dependências no 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 seu app.

  2. Inclua a dependência de cada SDK exigido pelo app. Esta página inclui uma seção que lista dependências comuns do Google Play Services para apps Android. Talvez você também queira 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 localização:

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 da versão. Caso o app use uma dependência atualizada, mude para a versão mais recente nas dependências para aproveitar essas correções.

Verificar se o Google Play Services está instalado

Conforme descrito na Visão geral do Google Play Services, ele recebe atualizações automáticas no Android 4.4 (nível 19 da API) e versões mais recentes pelo app Google Play Store. No entanto, 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, confira se ele está instalado antes de tentar usar APIs do Google ou ative os recursos que precisam do 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 aprender a detectar se a versão do Google Play Services instalada é compatível com uma API específica, leia o guia em 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 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 digitando o texto na caixa que aparece após os botões.

Tabela 1. Dependências do Google Play Services a serem incluídas em apps Android
Nome do caso de uso e dependência Dispositivos com suporte
Anúncios para dispositivos móveis do Google
com.google.android.gms:play-services-ads:21.5.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 Chrome OS
Versão leve dos anúncios para dispositivos móveis do Google
com.google.android.gms:play-services-ads-lite:21.5.0
Smartphone, tablet
Anúncios personalizados de pesquisa (CSAs) do AdSense para pesquisas (AFS)
com.google.android.gms:play-services-afs-native:19.0.3
Smartphone, tablet e Chrome OS
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 e Android TV
ID do conjunto de apps Android
com.google.android.gms:play-services-appset:16.0.2
Smartphone, tablet, Android TV e Chrome OS
Login do Google para Android
com.google.android.gms:play-services-auth:20.4.1
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 e Android Go
API Block Store (inclui armazenamento de credenciais do usuário)
com.google.android.gms:play-services-auth-blockstore:16.1.0
Smartphone, tablet, Android Go, ChromeOS
API Google Awareness
com.google.android.gms:play-services-awareness:19.0.1
Smartphone, tablet, Auto, Android Go, ChromeOS
Classes de serviços públicos
com.google.android.gms:play-services-base:18.1.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.1.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.2.0
Smartphone, tablet, Android Go, ChromeOS
CAF Application Framework (CAF) do Google Cast
com.google.android.gms:play-services-cast-framework:21.2.0
Smartphone, tablet, Android Go, ChromeOS
Receptores do Android TV
com.google.android.gms:play-services-cast-tv:20.0.0
Android TV
Leitor de código do Google
com.google.android.gms:play-services-code-scanner:16.0.0-beta3
Smartphone, tablet, Android Go, ChromeOS
Pilha de rede do 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 e Android Go
Autenticação on-line de Entidade rápida (FIDO, na sigla em inglês)
com.google.android.gms:play-services-fido:19.0.1
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS

Compatível com dispositivos com 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 e ChromeOS
SDK dos serviços relacionados a jogos do Google Play v2 C para Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Smartphone, tablet, Android TV, Android Go e 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 e 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 com o Android 5.0 (API de nível 21) ou versões mais recentes.
Provedor de localização combinada para Android (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 de código de barras do Kit de ML
com.google.android.gms:play-services-mlkit-barcode-scanning:18.1.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
Rotulagem de imagem do Kit de ML
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Smartphone, tablet, Android Go, ChromeOS
Rótulo personalizado da 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 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
Reconhecimento de texto do Kit de ML
com.google.android.gms:play-services-mlkit-text-recognition:18.0.2
Smartphone, tablet, Android Go, ChromeOS
Conexão e descoberta de dispositivos por perto
com.google.android.gms:play-services-nearby:18.4.0
Smartphone, tablet, Android TV, Auto e Android Go
Mostrar licenças de código aberto
com.google.android.gms:play-services-oss-licenses:17.0.0
Smartphone, tablet, Android TV, Auto, Android Go e Chrome OS
Compatível com dispositivos com 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 e Wear OS

Compatível com dispositivos com Android 4.4 (API de nível 19) a Android 9 (API de nível 28).
Google Pay for Passes
com.google.android.gms:play-services-pay:16.1.0
Smartphone, tablet, Android Go e ChromeOS

Compatível com dispositivos com 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 e 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 e 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
API TensorFlow Lite Delegate API para o Google Play Services
com.google.android.gms:play-services-tflite-gpu:16.1.0
Smartphone, tablet, Android Go, ChromeOS
API TensorFlow Lite Java para Google Play Services
com.google.android.gms:play-services-tflite-java:16.0.1
Smartphone, tablet, Android Go, ChromeOS
API TensorFlow Lite Support para Google Play Services
com.google.android.gms:play-services-tflite-support:16.0.1
Smartphone, tablet, Android Go, ChromeOS
API Thread Network
com.google.android.gms:play-services-threadnetwork:16.0.0-beta02
Smartphone, tablet
Visão 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.1.0
Smartphone, tablet, Auto, Android Go, ChromeOS, 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. 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 para Gradle Dispositivos com suporte
Mostrar licenças de código aberto
com.google.android.gms:oss-licenses-plugin:0.10.6
Smartphone, tablet e Chrome OS
Verificação de versão rigorosa
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS