Esta página foi traduzida pela API Cloud Translation.

Receber um ID do cliente do OAuth 2.0

Visão geral

Para usar o Google Fit para Android, você precisa de um ID do cliente OAuth 2.0 para aplicativos Android.

Todos os apps Android são assinados com um certificado digital para o qual você detém a chave privada. Consulte o guia do Android para assinar seus aplicativos e veja mais informações sobre certificados digitais.

Os IDs do cliente OAuth do Android são vinculados a pares de certificado/pacote específicos. Você só precisa de um código para cada certificado, independentemente de quantos usuários tem para o aplicativo.

A obtenção de um ID para seu aplicativo requer várias etapas. Essas etapas estão descritas abaixo.

Encontre as informações do certificado do seu aplicativo.
Crie ou modifique um projeto no Console de APIs do Google.
Solicite um ID do cliente OAuth 2.0.

Encontrar as informações do certificado do seu aplicativo

A chave de API é baseada em uma forma resumida do certificado digital do seu app, conhecida como impressão digital SHA-1. Para exibir a impressão digital SHA-1 do seu certificado, primeiro verifique se você está usando o certificado correto. Você pode ter dois certificados:

Um certificado de depuração: as Ferramentas do SDK do Android geram esse certificado automaticamente quando você faz um build de depuração. Use-o apenas com apps em teste. Não tente publicar um aplicativo assinado com um certificado de depuração. Veja mais detalhes sobre esse certificado em Fazer login no modo de depuração, na documentação do desenvolvedor Android.
Um certificado de lançamento: as Ferramentas do SDK do Android geram esse certificado quando você faz um build de lançamento. Também é possível gerá-lo usando o programa keytool. Utilize esse certificado quando tudo estiver pronto para lançar seu app.

Siga as etapas abaixo para exibir a impressão digital SHA-1 do certificado usando o programa keytool com o parâmetro -v. Para mais informações sobre o Keytool, consulte a documentação da Oracle.

Certificado de depuração

Exibir a impressão digital do certificado de depuração

Localize o arquivo de keystore de depuração. O nome do arquivo é debug.keystore, e ele é gerado no momento em que você cria seu projeto. Por padrão, ele fica armazenado no mesmo diretório que os arquivos do Dispositivo virtual Android (AVD, na sigla em inglês):
- macOS e Linux: ~/.android/
- Windows Vista e Windows 7: C:\Users\your_user_name\.android\

Liste a impressão digital SHA-1:

Para Linux ou macOS, abra uma janela do terminal e digite o seguinte:

keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

No Windows Vista e Windows 7, execute este código:

keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Será exibida uma saída semelhante a esta:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

Certificado de lançamento

Exibir a impressão digital do certificado de lançamento

Localize o arquivo de keystore do certificado de lançamento. Não há local nem nome padrão para o keystore de lançamento. Se você não especificar esses itens ao criar seu app, .apk ficará sem assinatura, e será preciso assiná-lo antes da publicação. Para o certificado de lançamento, você também precisa do alias do certificado e das senhas do keystore e do certificado. É possível listar os aliases de todas as chaves em um keystore digitando o seguinte:
```
keytool -list -keystore your_keystore_name
```
Substitua your_keystore_name pelo caminho e nome totalmente qualificados do keystore, incluindo a extensão .keystore. Você precisará inserir a senha do keystore. Em seguida, keytool exibirá todos os aliases relevantes.
Digite o seguinte em um terminal ou no prompt de comando:
```
keytool -list -v -keystore your_keystore_name -alias your_alias_name
```
Substitua your_keystore_name pelo caminho e nome totalmente qualificados do keystore, incluindo a extensão .keystore. Troque your_alias_name pelo alias que você atribuiu ao certificado quando o criou.

Será exibida uma saída semelhante a esta:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

A linha que começa com SHA1 inclui a impressão digital SHA-1 do certificado. Essa impressão é a sequência de 20 números hexadecimais de dois dígitos separados por dois pontos.

Atenção: para proteger o keystore e a chave, não insira os argumentos storepass ou keypass na linha de comando, a menos que possa garantir a segurança do seu computador. Por exemplo, em um computador público, alguém poderia visualizar o histórico da janela do terminal ou a lista de processos em execução, conseguir a senha e ter acesso de gravação ao seu certificado de assinatura. Assim, essa pessoa poderia modificar o app ou substituí-lo por outro.

Solicitar um ID do cliente OAuth 2.0 no Console de APIs do Google

Siga estas etapas para criar ou modificar um projeto para seu app no Console de APIs do Google, ativar a API Fitness e solicitar um ID do cliente OAuth 2.0.

Se você quiser ser guiado pelo processo e ativar a API Fitness automaticamente, clique em

Receber um ID do cliente

Como alternativa, siga estas etapas para ativar a API Fitness no Console de APIs do Google e receber um ID do cliente OAuth 2.0.

Acesse o Console de APIs do Google.
Selecione um projeto ou crie um novo. Use o mesmo projeto para as versões Android e REST do seu app.
Clique em Continuar para ativar a API Fitness.
Clique em Acessar credenciais.
Clique em Novas credenciais e selecione ID do cliente OAuth.
Em Tipo de aplicativo, selecione Android.
Na caixa de diálogo resultante, insira a impressão digital SHA-1 e o nome do pacote do aplicativo. Por exemplo:

BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.fit-example
Clique em Criar. O novo ID do cliente OAuth 2.0 do Android e a nova chave secreta aparecem na lista de IDs do projeto. Um ID do cliente OAuth 2.0 é uma string de caracteres semelhante a esta:

780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com