Acesso e autorização de dados

A API Google Health usa um framework robusto e padronizado para gerenciar o acesso e a segurança dos dados do usuário. Um componente central dessa modernização é a transição da autorização legada do Fitbit (FOT) para o OAuth 2.0 do Google. Essa mudança permite que os desenvolvedores usem as bibliotecas de autenticação padrão do Google, simplificando a implementação e oferecendo aos usuários uma interface familiar e centralizada para gerenciar as permissões.

Registro do app

Todos os apps da API Google Health precisam ser registrados usando o console do Google Cloud, que serve como um hub central para gerenciar todos os seus apps do Google.

Para instruções sobre como registrar seu app, siga as etapas em Primeiros passos. Confira as diferenças que você vai notar ao registrar seus apps.

API Fitbit Web API Google Health
Links públicos https://dev.fitbit.com/apps https://console.cloud.google.com
Adicionar um novo app Pressione Registrar um novo app.
  1. Criar um projeto do Google Cloud
  2. Ative a API Google Health.
Informações básicas Campos a serem preenchidos:
  • Nome do aplicativo
  • Descrição
  • URL do site do aplicativo
  • Organização
  • URL do site da organização
  • URL dos Termos de Serviço
  • URL da Política de Privacidade
Campos a serem preenchidos:
  • Nome do aplicativo
  • E-mail para suporte
  • Público-alvo (interno ou externo)
  • E-mail de contato
  • Ícone do logotipo
  • URL do site do aplicativo
  • URL da Política de Privacidade
  • URL dos Termos de Serviço
  • Domínio autorizado
Tipos de aplicativos O desenvolvedor precisa selecionar:
  • Servidor
  • Cliente
  • Pessoal
  • Aplicativo da Web
  • Android
  • Extensão do Chrome
  • iOS
  • TVs
  • App para computador
  • Plataforma Universal do Windows
ID do cliente Registrado quando as configurações do aplicativo são salvas Registrado separadamente
Tipo de acesso O acesso de leitura e gravação é controlado no nível do app O acesso de leitura e gravação é controlado no nível do escopo
Outros URLs
  • URL de redirecionamento: site para onde os usuários são redirecionados depois de autorizarem os escopos.
  • Origens JavaScript autorizadas: origem HTTP que hospeda o aplicativo da Web
  • URL de redirecionamento: site para onde os usuários são redirecionados depois de autorizarem os escopos.

Implementação do OAuth

Os apps da API Google Health só são compatíveis com as bibliotecas de cliente do Google OAuth2. As bibliotecas de cliente estão disponíveis para frameworks conhecidos, o que simplifica a implementação do OAuth 2.0.

As diferenças entre as bibliotecas do Google OAuth2 e as bibliotecas OAuth2 de código aberto são as seguintes:

API Fitbit Web API Google Health
Suporte à biblioteca OAuth2 Código aberto Bibliotecas de cliente do Google OAuth2
Funcionalidade Inconsistente em todas as plataformas Consistente em todas as plataformas
URL de autorização https://www.fitbit.com/oauth2/authorize https://accounts.google.com/o/oauth2/v2/auth
URL do token https://api.fitbit.com/oauth2/token https://oauth2.googleapis.com/token
Ciclo de vida do token de acesso 8 horas 1 hora
Tamanho do token de acesso 1.024 bytes 2.048 bytes
Token de atualização Os tokens de atualização são gerados ao usar o fluxo de concessão de código de autorização. Só é possível gerar um token de atualização para um usuário. Os tokens nunca expiram e só podem ser usados uma vez. Para gerar um token de atualização, a string de autorização precisa conter o parâmetro de consulta "access_type=offline". É possível criar vários tokens de atualização para um único usuário. Os tokens de atualização podem ser baseados em tempo. Eles vão expirar se não forem usados em seis meses, se o usuário conceder acesso com base no tempo ou se o app estiver no modo "Teste". Confira mais detalhes em Validade do token de atualização.
Resposta de token A resposta JSON contém:
  • token de acesso
  • validade do token de acesso
  • escopos
  • tipo de token
  • token de atualização
  • ID do usuário
A resposta JSON contém:
  • token de acesso
  • validade do token de acesso
  • escopos
  • tipo de token
  • token de atualização

Para receber o ID do usuário, chame o endpoint users.getIdentity depois que pelo menos um escopo do Google Health for concedido e mantenha os tokens legados do Fitbit ativos até que legacyUserId seja verificado.

Os usuários do Fitbit precisam consentir novamente com a nova integração, porque seu app está usando uma biblioteca OAuth diferente. Não é possível transferir tokens de acesso e tokens de atualização para a API Google Health e fazê-los funcionar.

Cada usuário que dá um novo consentimento conta para o limite de taxa de concessão de token OAuth do seu projeto do Google Cloud. O Google Cloud aplica uma limitação de taxa às concessões de token OAuth para controlar a velocidade com que seu app pode integrar ou autenticar novamente os usuários. Se você espera exceder 10.000 inscrições ou reautenticações de usuários em um período de 24 horas, solicite uma cota maior com antecedência. Para mais informações, consulte Limitação de taxa de aplicativos OAuth.