Autorizar solicitações

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:

  1. 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.
  2. Ative a API Fitness no Console de APIs do Google. Se a API não estiver listada no console de APIs, pule esta etapa.
  3. 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.
  4. 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.
  5. Se o usuário aprovar, o Google fornecerá ao aplicativo um token de acesso de curta duração.
  6. O aplicativo solicita dados de usuário, anexando o token de acesso à solicitação.
  7. 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.