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 seu aplicativo usando o Google Play Services, você deve usar uma das seguintes opções:

  • Um dispositivo Android compatível com o Android 7.0 (nível 24 da API) ou mais recente e com o app Google Play Store instalado.
  • O Android Emulator com um AVD que executa a plataforma de APIs do Google com base no Android 7.0 (nível da API 24) ou mais recente.

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 aplicativo.

  2. Para cada SDK que seu aplicativo requer, 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. Você também pode querer 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.4.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 da versão. 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.

Verifique 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 7.0 (nível 24 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 então iniciar uma conexão com o Google Play Services ou aprender como detectar se a versão do Google Play Services instalada oferece suporte a uma API específica, leia o guia sobre Acessando APIs do Google.

Dependências do Google Play Services

A tabela a seguir lista as dependências do Google Play Services que você pode incluir em seu app Android. Você pode filtrar a lista por tipo de dispositivo selecionando um dos botões e pode pesquisar um caso de uso específico ou o nome de uma dependência 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 aplicativos Android
Caso de uso e nome da dependência Dispositivos compatíveis
Anúncios para dispositivos móveis do Google
com.google.android.gms:play-services-ads:25.4.0
Smartphone, tablet
ID de publicidade do Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.3.0
Telefone, tablet, Android TV, ChromeOS
Versão leve do Google Mobile Ads
com.google.android.gms:play-services-ads-lite:25.0.0
Telefone, Tablet
Anúncios personalizados de pesquisa (CSA) do AdSense para pesquisas (AFS)
com.google.android.gms:play-services-afs-native:19.1.0
Telefone, 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
Telefone, tablet, Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
Telefone, tablet, Android TV
ID do conjunto de apps Android
com.google.android.gms:play-services-appset:16.1.0
Telefone, tablet, Android TV, ChromeOS
Login do Google para Android
com.google.android.gms:play-services-auth:22.0.0
Telefone, tablet, Android TV, carro, Android Go, ChromeOS
API SMS Retriever
com.google.android.gms:play-services-auth-api-phone:18.3.1
Telefone, 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:20.0.0
Smartphone, tablet, Auto, Android Go, ChromeOS
Classes de utilitário
com.google.android.gms:play-services-base:18.10.1
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Testando falsos para classes utilitárias
com.google.android.gms:play-services-base-testing:16.2.0
Telefone, tablet, Android TV, carro, Android Go, ChromeOS, Wear OS
Mais classes de utilitários
com.google.android.gms:play-services-basement:18.11.0
Telefone, tablet, Android TV, carro, Android Go, ChromeOS, Wear OS
Melhoria da câmera em pouca luz
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09
Telefone, Tablet
Google Cast
com.google.android.gms:play-services-cast:22.3.1
Telefone, tablet, Android Go, ChromeOS
Framework de aplicativos Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:22.3.1
Telefone, tablet, Android Go, ChromeOS
Leitor de código do Google
com.google.android.gms:play-services-code-scanner:16.1.0
Telefone, tablet, Android Go, ChromeOS
Pilha de rede Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.1.1
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
SDK Verificador de Chaves
com.google.android.gms:contactkeys:16.0.0
Telefone, Tablet
Autenticação FIDO (Fast IDentity Online)
com.google.android.gms:play-services-fido:21.3.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 de gravação em dispositivos móveis (para dados de condicionamento físico do usuário)
com.google.android.gms:play-services-fitness:21.3.0
Smartphone, tablet, Android Go, ChromeOS, Wear OS
Proteção contra Fraude
com.google.android.gms:play-services-fraudprotect:16.0.1
Telefone, tablet, Android Go
Serviços do Google Play Games v2 para Android
com.google.android.gms:play-services-games-v2:22.1.0
Telefone, tablet, Android TV, Android Go, ChromeOS
SDK nativo C dos Serviços do Google Play Games 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 do Google Play Games v1 para Android
com.google.android.gms:play-services-games:25.0.0
Obsoleto. Use os Serviços do Google Play Games v2.
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 obter mais informações.
Serviços de localização para Android
com.google.android.gms:play-services-location:21.4.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK do Maps para Android
com.google.android.gms:play-services-maps:20.0.0
Telefone, tablet, Android TV, carro, Android Go, ChromeOS, Wear OS
SDK do Google Maps 3D para Android
com.google.android.gms:play-services-maps3d:0.2.2
Smartphone, tablet
Melhoria do efeito de mídia
com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08
Telefone, Tablet
Leitura de código de barras do kit ML
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
Telefone, tablet, Android Go, ChromeOS
Scanner de documentos do Kit de ML
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Kit de ML de detecção facial
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Smartphone, tablet, Android Go, ChromeOS
Kit de ML para rotulagem de imagens
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefone, tablet, Android Go, ChromeOS
Personalização da rotulagem de imagens do Kit de ML
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
Telefone, tablet, Android Go, ChromeOS
Resposta inteligente do Kit de ML
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Telefone, 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
Telefone, tablet, Android Go, ChromeOS
Reconhecimento de texto do Kit de ML
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
Telefone, 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
Telefone, tablet, Android Go, ChromeOS
Kit de reconhecimento de texto ML para Devanagari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
Smartphone, tablet, Android Go, ChromeOS
Kit de reconhecimento de texto Kit de ML para japonês
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
Telefone, 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
Telefone, tablet, Android Go, ChromeOS
Detecção e conexão de dispositivos próximos
com.google.android.gms:play-services-nearby:19.5.0
Telefone, tablet, Android TV, carro, Android Go
Mostrar licenças de código aberto
com.google.android.gms:play-services-oss-licenses:17.5.2
Telefone, tablet, Android TV, carro, Android Go, ChromeOS
Compatível com dispositivos que executam Android 5.0 (nível da API 21) ou superior.
Bibliotecas de Acesso Programático (PAL)
com.google.android.gms:play-services-pal:23.0.0
Telefone, tablet, Android TV
Compatível com dispositivos que executam Android 5.0 (nível da API 21) ou superior.
Verificação de qualidade do bloqueio de tela
com.google.android.gms:play-services-password-complexity:18.1.0
Telefone, tablet, Android Go, ChromeOS, Wear OS

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

Compatível com dispositivos que executam Android 5.0 (nível da API 20) ou superior.
reCAPTCHA Enterprise para instrumentação de aplicativos
com.google.android.gms:play-services-recaptcha:17.1.0
Telefone, tablet, Android TV, Android Go, ChromeOS
API de gestos remotos
com.google.android.gms:play-services-remotegestures:16.0.0
Telefone, Tablet
Navegação Segura v5
com.google.android.gms:play-services-safebrowsing:16.0.0
Telefone, tablet, Android TV, carro, Android Go, ChromeOS
APIs do SafetyNet (inclui navegação segura e aplicativos de verificação)
com.google.android.gms:play-services-safetynet:18.1.0
Telefone, tablet, Android TV, carro, Android Go, ChromeOS
Google Tag Manager
com.google.android.gms:play-services-tagmanager:18.3.0
Telefone, tablet, Android TV, Android Go, ChromeOS
API Tasks no Android
com.google.android.gms:play-services-tasks:18.4.1
Telefone, 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.5.0-beta02
Telefone, 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.5.0
Telefone, tablet, Android Go, ChromeOS
API Java do TensorFlow Lite para o Google Play Services
com.google.android.gms:play-services-tflite-java:16.5.0
Telefone, tablet, Android Go, ChromeOS
API de suporte do TensorFlow Lite para o Google Play Services
com.google.android.gms:play-services-tflite-support:16.5.0
Telefone, tablet, Android Go, ChromeOS
API de Rede Thread
com.google.android.gms:play-services-threadnetwork:16.3.0
Telefone, Tablet
API de Tempo Confiável
com.google.android.gms:play-services-time:16.0.1
Telefone, tablet, carro, Android Go, Wear OS
Visão Móvel
com.google.android.gms:play-services-vision:20.1.3
Telefone, tablet, Android Go, ChromeOS
Google Pay para pagamentos no Android
com.google.android.gms:play-services-wallet:20.0.0
Telefone, tablet, carro, Android Go, ChromeOS, Wear OS
API da Camada de Dados Vestíveis
com.google.android.gms:play-services-wearable:20.0.1
Telefone, tablet, Wear OS

Plugins 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 nesta tabela.

Tabela 2. Lista de plug-ins do Gradle incluídos nos Serviços do Google Play
Caso de uso e nome do plugin Gradle Dispositivos compatíveis
Mostrar licenças de código aberto
com.google.android.gms:oss-licenses-plugin:0.13.0
Telefone, tablet, ChromeOS
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