As APIs Google Fit, incluindo a API REST Google Fit, não estarão mais disponíveis após 30 de junho de 2025. Desde 1o de maio de 2024, os desenvolvedores não podem se inscrever para usar essas APIs.

Para instruções sobre para qual API ou plataforma migrar, acesse o guia de migração do app Conexão Saúde. Para comparar o app Conexão Saúde com as APIs do Google Fit e as APIs da Fitbit Web, acesse o guia de comparação do app Conexão Saúde.

Saiba mais sobre o app Conexão Saúde e como fazer a integração com a API.

Esta página foi traduzida pela API Cloud Translation.

Sessões

As sessões são uma maneira de os usuários verem de forma rápida e fácil uma lista de todos os principais as atividades que ele realizou. Elas aparecem na página de diário do app Google Fit. Para por exemplo, uma sessão de respiração, uma caminhada, uma corrida ou uma noite de sono exemplos de uma sessão.

As sessões agrupam conjuntos de dados de um período específico coletados durante uma atividade. Por exemplo, se um usuário rastreou quando começou e terminou uma corrida de 3 km correr, uma sessão pode ser criada e todos os dados de condicionamento físico dentro desse tempo (como passos, velocidade, distância) seria associado a essa sessão.

As sessões em si não contêm detalhes sobre a atividade. Ela está na no conjunto de dados. As sessões têm estas propriedades:

Um nome descritivo e fácil de usar (por exemplo, "corrida matinal")
uma descrição
Um identificador exclusivo
O tipo de atividade sendo capturada (por exemplo, uma corrida)

Benefícios de usar sessões

Útil para os usuários: as sessões ajudam a organizar dados de atividades e treinos em uma significativa para os usuários. Eles podem ver todas as atividades do dia em Página do diário no app Google Fit.
Experiência do usuário consistente: se o app ou dispositivo complementar permite atividade acompanhamento (onde os usuários podem iniciar e interromper uma atividade), ter sessões para esses treinos permitem que os usuários vejam a atividade deles em ambos os aplicativos.
Dados mais completos: o Google Fit também mescla dados de vários fontes para complementar e enriquecer as informações da sua sessão. Isso dá aos usuários uma imagem mais completa da atividade.
usar a plataforma Google Fit: se os usuários não monitorarem a atividade deles; seu app não for compatível com o monitoramento, você ainda poderá ler as sessões no Google Fit. Você pode consultar dados detalhados ou agregados da loja de condicionamento físico e encontrar disponíveis, sem precisar implementar seu próprio esquema e armazenamento.
Maior engajamento do usuário: você pode mostrar aos usuários as sessões disponíveis e as e apps que os criaram. Interagir com outros aplicativos de condicionamento físico dessa forma poderia aumentar o engajamento dos usuários.

Como receber autorização do usuário para sessões

Se você quiser ler ou gravar sessões, seu app precisa da permissão. O acesso a sessões usa os mesmos escopos de autorização como tipos de dados, que precisam ser solicitados da seguinte maneira:

Android

Especifique o tipo de sessão que o app precisa acessar, usando o método de FitnessOptions. Por exemplo, para ler sessões relacionadas à corrida, você pode escolher:

    val fitnessOptions = FitnessOptions.builder()
        .accessActivitySessions(FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
        .build()

Este exemplo especifica que o app quer acessar os metadados da sessão de atividade, e especifica os tipos de dados que serão lidos nessas sessões. as Os tipos de dados de frequência cardíaca, velocidade e local são usados neste exemplo.

REST

Escopos da solicitação da seguinte maneira:

Sessões com tipos de atividade de sono:
- https://www.googleapis.com/auth/fitness.sleep.read
- https://www.googleapis.com/auth/fitness.sleep.write
Todas as outras sessões:
- https://www.googleapis.com/auth/fitness.activity.read
- https://www.googleapis.com/auth/fitness.activity.write

Como usar sessões

Android

Você pode usar a API Sessions para:

Criar sessões em tempo real
Inserir sessões na loja de condicionamento físico
Insira segmentos de atividade para dar suporte a pausas durante os treinos
Ler sessões e conjuntos de dados associados a elas
Iniciar outro app para mostrar informações sobre uma sessão criada por ele
Receber uma intent quando outro app iniciar uma sessão

REST

Você pode usar a API Sessions para:

Criar sessões em tempo real
Inserir sessões na loja de condicionamento físico
Insira segmentos de atividade para dar suporte a pausas durante os treinos
Ler sessões e conjuntos de dados associados a elas

Como os conjuntos de dados e segmentos interagem com as sessões

No Google Fit:

Um conjunto de dados representa um conjunto de pontos de dados de um determinado origem de dados sobre um período específico. É possível inserir os conjuntos de dados por conta própria. Mas se você estiver criando uma sessão, pode ser mais fácil criar a e seus conjuntos de dados.
Um segmento agrupa os conjuntos de dados em uma sessão pela atividade exata do usuário estava fazendo na sessão. Por exemplo, se o usuário rastrear uma corrida de 30 minutos (o mas caminhamos por um tempo durante esta etapa, isso pode ser dividido em segmentos. Havia um segmento para a corrida, depois uma pausa para caminhada e o executar novamente.

**Figura 1**: apps diferentes adicionam sessões e conjuntos de dados ao [fitness store].

A Figura 1 mostra um intervalo de tempo no armazenamento de condicionamento físico em que os apps A, B e C foram inseridos alguns conjuntos de dados e sessões:

O app A inseriu os conjuntos de dados A1 e A2 com a Sessão 1 e A3, independentemente de qualquer sessão.
O app B inseriu os conjuntos de dados B1 e B2 com a Sessão 2.
O app C inseriu o conjunto de dados C1 independentemente de qualquer sessão.

Ao ler dados de sessão do armazenamento de condicionamento físico, todos os dados de condicionamento físico que se enquadram no intervalo de tempo de uma sessão é automaticamente associado a essa mesmo que você insira os dados depois de criar a sessão ou crie uma após os dados terem sido acompanhados passivamente. Por exemplo, uma consulta sobre condicionamento físico os dados da Sessão 1 retornariam:

Conjunto de dados A1
Conjunto de dados A2
A parte do conjunto de dados A3 entre t1 e t2
A parte do conjunto de dados C1 entre t1 e t2

É possível saber qual app inseriu cada sessão e conjunto de dados.

Criar sessões

As sessões podem ser criadas de algumas maneiras diferentes:

Seu app pode criar ativamente uma sessão
- Em tempo real quando um usuário monitora ativamente uma atividade em um dispositivo (somente Android) ou
- inserindo-o manualmente.
Quando um usuário adiciona manualmente um treino ou uma atividade no app Google Fit.

Quando criar uma sessão

Você está adicionando dados de sono?

Sim: crie uma sessão e insira manualmente na loja de fitness. Por exemplo, a inserção de uma sessão de sono. Isso é porque os usuários com aplicativos ou dispositivos de monitoramento do sono não interagem com os dispositivos para iniciar e interromper sua atividade de sono (isso é monitorado passivamente).
Não: o app permite que os usuários iniciem e interrompam atividades?
- Não: não crie uma sessão. Adicione apenas conjuntos de dados do seu aplicativo.
- Sim: com a API Android, crie uma sessão em tempo real se os usuários rastrearem pela atividade ou manualmente. Com a API REST, crie uma sessão e insira manualmente na loja de fitness.
- Seu aplicativo pode detectar quando um usuário está realizando atividades diferentes em um nível detalhado (por exemplo, caminhada versus corrida)?
  - Sim: adicione segmentos.
  - Não: adicione apenas conjuntos de dados. Ignorar e deixar que o Google Fit os crie de forma passiva.

Sessões de leitura

Seu app pode ler sessões de algumas maneiras:

Procure uma sessão específica que ele criou/inseriu.
- Nome ou
- ID
Procure todas as sessões que ele criou/inseriu por período
Procurar todas as sessões disponíveis criadas por todos os apps (incluindo o Google Fit) por período

Saber quais origens criaram uma sessão

Você pode mostrar aos usuários qual app ou dispositivo criou cada uma das sessões. Cada sessão tem uma fonte de dados associada, que contém informações sobre o aplicativo ou dispositivo que coletava ou transformava os dados.

Android

No momento, só é possível obter o nome do pacote de uma sessão gravada por uma para o cliente. Para obter o nome do pacote do aplicativo que criou uma sessão, use o comando método getAppPackageName. Você pode usar essas informações no app para mostrar aos usuários quais outros aplicativos inseriram sessões de condicionamento físico. Você pode mostrar o ícone do cada um desses de apps para ajudar os usuários a identificá-los.

Também é possível disparar uma intent de iniciar outros apps para mostrar detalhes das sessões criadas; Outros apps também podem disparar uma intenção de lançar seu aplicativo.

Saiba mais sobre como encontrar a fonte que criou uma sessão.

REST

Para obter o nome do pacote do aplicativo Android que criou sessões, use o comando propriedade session.application. Para sessões criadas usando o API REST, use a propriedade session.name. Você pode usar isso informações em seu aplicativo para mostrar aos usuários quais outros aplicativos inseriram dados de condicionamento físico de conteúdo. Você pode mostrar o ícone de cada um desses apps para ajudar os usuários a identificar para resolvê-los com rapidez.

Saiba mais sobre como encontrar a fonte que criou uma sessão.