Esta página foi traduzida pela API Cloud Translation.

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

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

Observação: os projetos do Android Studio contêm um arquivo build.gradle de nível superior e um arquivo build.gradle para cada módulo. Edite o arquivo para o módulo do seu app. Saiba mais sobre como criar seu projeto com o Gradle.
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.
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.2.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.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.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`	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