Todas as solicitações que seu aplicativo envia para a API Fitness precisam incluir um token de autorização. O token também identifica o aplicativo para o Google.
Protocolo de autorização
O app precisa usar o OAuth 2.0 para autorizar as solicitações. Nenhum outro protocolo de autorização é aceito. Se o aplicativo usa o Login do Google, alguns aspectos da autorização são administrados para você.
Os tipos de dados que seu app quer acessar correspondem a escopos. Antes de acessar os tipos de dados, você precisará identificar se os escopos correspondentes são sensíveis ou restritos e seguir as etapas relevantes ao solicitar a verificação. Veja a etapa 3 de como autorizar solicitações abaixo.
Autorizar solicitações com OAuth 2.0
Todas as solicitações para a API Fitness precisam ser autorizadas por um usuário autenticado.
Os detalhes do processo de autorização, ou "fluxo," para o OAuth 2.0, dependerão do tipo de app que você está criando. Esse processo geral se aplica a todos os tipos de apps:
- Ao criar seu aplicativo, registre-o usando o Console de APIs do Google. Em seguida, o Google fornece informações que serão necessárias mais tarde, como um ID e uma chave secreta do cliente.
- Ative a API Fitness no Console de APIs do Google. Se a API não estiver listada no console de APIs, pule esta etapa.
- Solicite a verificação e envie as informações de suporte relevantes sobre por que o app precisa de determinados escopos. Os tipos de dados que seu app precisa acessar correspondem aos escopos que seu app precisa solicitar.
- Se o app for verificado, o Google exibirá uma tela de consentimento ao usuário, solicitando que ele autorize o acesso do app aos dados.
- Se o usuário aprovar, o Google fornecerá ao aplicativo um token de acesso de curta duração.
- O aplicativo solicita dados de usuário, anexando o token de acesso à solicitação.
- Se o Google determinar que sua solicitação e o token são válidos, ele retornará os dados solicitados.
Leia sobre os escopos do OAuth da API Fitness aqui. Procure qual escopo é necessário para cada tipo de dados.