Escopos

Todos os endpoints da API Google Health que leem e gravam dados do usuário exigem o consentimento do usuário para essa coleta de dados por um ou mais escopos. O app precisa fornecer a lista de escopos ao chamar o endpoint de autenticação OAuth2 do Google. Consulte Como conseguir tokens de acesso OAuth2 . O token de acesso emitido só vai conter os escopos que o usuário consentido autorizou.

Todos os escopos da API Google Health começam com:

https://www.googleapis.com/auth/googlehealth

Implementação

Para oferecer a melhor experiência do usuário e garantir a conformidade de segurança, ao solicitar escopos, você precisa:

  • Solicitar apenas os escopos necessários: solicite acesso apenas aos escopos de dados específicos que seu aplicativo precisa para funcionar.
  • Configurar o acesso de gravação apenas ao enviar dados: configure o acesso de "gravação" (por exemplo, usando um escopo writeonly) apenas se você estiver enviando dados para o Google Health.
  • Processar o consentimento parcial corretamente: seu aplicativo não poderá falhar se um usuário não selecionar todos os escopos apresentados na tela de permissão.
    • Se o aplicativo exigir todos os escopos apresentados para funcionar, você poderá apresentar o texto: "Para a melhor experiência do usuário, recomendamos ativar todos os escopos."

Escopos disponíveis

Tabela: escopos da API Google Health
Escopo Permissão
.activity_and_fitness.readonly Ver seus dados de atividade e condicionamento físico do Google Health.
.activity_and_fitness.writeonly Adicionar dados de atividade e condicionamento físico ao Google Health e editar ou excluir os dados adicionados.
.ecg.readonly Ver seus dados de eletrocardiograma do Google Health.
.health_metrics_and_measurements.readonly Ver seus dados de métricas de saúde e medição do Google Health.
.health_metrics_and_measurements.writeonly Adicionar dados de métricas de saúde e medições ao Google Health e editar ou excluir os dados adicionados.
.irn.readonly Ver seus dados de notificações de ritmo irregular do Google Health.
.location.readonly Ver sua localização por GPS do Google Health registrada durante um exercício.
.nutrition.readonly Ver seus dados de nutrição do Google Health.
.nutrition.writeonly Adicionar dados de nutrição ao Google Health e editar ou excluir os dados adicionados.
.profile.readonly Ver os dados do seu perfil do Google Health.
.profile.writeonly Adicionar dados de perfil ao Google Health e editar ou excluir os dados adicionados.
.settings.readonly Ver suas configurações do Google Health.
.settings.writeonly Adicionar dados de configurações ao Google Health e editar ou excluir os dados adicionados.
.sleep.readonly Ver seus dados de sono do Google Health.
.sleep.writeonly Adicionar dados de sono ao Google Health e editar ou excluir os dados adicionados.