A API Google Health utiliza uma estrutura robusta e padronizada para gerenciar o acesso aos dados do usuário e a segurança. Um componente central dessa modernização é a transição da autorização legada do Fitbit (FOT) para o Google OAuth 2.0. Essa mudança permite que os desenvolvedores aproveitem 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 apps do Google.
Para instruções sobre como registrar seu app, siga as etapas em Introdução. 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 | Clique em Registrar um novo app |
|
| Informações básicas | Campos a serem preenchidos:
|
Campos a serem preenchidos:
|
| Tipos de aplicativo | Um 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ó oferecem suporte às 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 de código aberto do OAuth2 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 várias plataformas | Consistente em várias 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 |
| Tempo 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". Vários tokens de atualização podem ser criados 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 concedeu acesso baseado em tempo ou se o app estiver no modo "Teste". Consulte Validade do token de atualização para mais detalhes. |
| Resposta do token | A resposta JSON contém:
|
A resposta JSON contém:
Para receber o ID do usuário, use o endpoint users.getIdentity. |
Reautenticação do usuário (novo consentimento obrigatório)
Os usuários do Fitbit precisam dar consentimento novamente para sua nova integração, porque o 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 fazer com que eles funcionem.