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. |
|
| Informações básicas | Campos a serem preenchidos:
|
Campos a serem preenchidos:
|
| Tipos de aplicativos | O desenvolvedor precisa selecionar:
|
|
| 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 |
|
|
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:
|
A resposta JSON contém:
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.
|
Reautenticação do usuário (novo consentimento obrigatório)
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.