Les API Google Fit, y compris l'API REST Google Fit, ne seront plus disponibles après le 30 juin 2025. Depuis le 1er mai 2024, les développeurs ne peuvent plus s'inscrire pour utiliser ces API.

Pour obtenir des instructions sur l'API ou la plate-forme vers laquelle effectuer la migration, consultez le guide de migration de Santé Connect. Pour comparer Santé Connect aux API Google Fit et Fitbit Web, consultez le guide comparatif Santé Connect.

Apprenez-en plus sur Santé Connect et sur l'intégration à l'API.

Cette page a été traduite par l'API Cloud Translation.

Types de données d'activité

Ces types de données peuvent être utilisés pour capturer les activités, les entraînements et les métriques concernant de l'exercice physique.

Activité

Ce type de données permet de capturer toute activité effectuée par un utilisateur. Il peut s'agir d'activités de remise en forme courantes comme la course à pied ou différents sports, ainsi que d'activités comme la méditation, le jardinage et le sommeil.

Si l'utilisateur a effectué plusieurs activités au cours de cette période, créez une une session pour le type d'activité principal et plusieurs segments pour les différents types d'activité. Par exemple, s'il a fait un peu de kick-boxing et de boxe lors d'un cours d'arts martiaux mixtes, créez une session pour les arts martiaux mixtes. Vous pouvez ensuite ventiler les différents types d'activités en segments.

Chaque point de données a besoin d'une heure de début et d'une heure de fin. Les points de données ne doivent pas être collés les uns aux autres. Il peut y avoir des écarts entre eux.

REST

Nom	`com.google.activity.segment`
Champs d'application des autorisations OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Champs (format – unités)	type d'activité (`int` : énumération) Type d'activité réalisée par l'utilisateur. Consultez la liste des types d'activités.

Android

Nom	`com.google.activity.segment`
Objet de type de données	`TYPE_ACTIVITY_SEGMENT`
Autorisation Android	`ACTIVITY_RECOGNITION`
Champs (format – unité)	FIELD_ACTIVITY (`int` : énumération) Type d'activité de l'utilisateur. Pour consulter la liste des types d'activités, cliquez ici.

Métabolisme de base (MB)

Ce type de données indique le métabolisme de base d'un utilisateur, en kilocalories. Chaque point de données représente le nombre de kilocalories qu'un utilisateur brûlerait s'il était au repos toute la journée, en fonction de sa taille et de son poids. Vous ne devez définir que l'heure de fin. Ce servira de code temporel pour la lecture.

REST

Nom	`com.google.calories.bmr`
Champs d'application des autorisations OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Champs (format – unités)	calories (`float` kcal par jour) Nombre de kilocalories qu'un utilisateur brûlerait au repos toute la journée, en fonction de sa taille et de son poids.

Android

Nom	`com.google.calories.bmr`
Objet de type de données	`TYPE_BASAL_METABOLIC_RATE`
Champs (format – unités)	FIELD_CALORIES (`float` : kcal par jour) Nombre de kilocalories qu'un utilisateur brûlerait au repos toute la journée, en fonction de son âge, de son poids et de sa taille.

Calories brûlées

Ce type de données capture le nombre total de calories (en kilocalories) brûlées selon le y compris les calories brûlées au repos. Chaque point de données représente le nombre total de kilocalories brûlées sur un intervalle de temps. Par conséquent, les heures de début et de fin doivent être définies.

REST

Nom	`com.google.calories.expended`
Champs d'application des autorisations OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Champs (format—units)	calories (`float` – kcal) Nombre de kilocalories brûlées.

Android

Nom	`com.google.calories.expended`
Objet de type de données	`TYPE_CALORIES_EXPENDED`
Autorisation Android	`ACTIVITY_RECOGNITION`
Champs (format – unités)	FIELD_CALORIES (`float` – kcal) Nombre de kilocalories brûlées.

Cadence de pédalage

Ce type de données permet aux utilisateurs de pédaler sur leur vélo. en tours de manivelle par minute (tr/min). Chaque point de données représente une mesure instantanée de la fréquence de pédalage. Par conséquent, seule l'heure de fin doit être définie. Il servira de code temporel pour la lecture.

REST

Nom	`com.google.cycling.pedaling.cadence`
Champs d'application des autorisations OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Champs (format—units)	tr/min (`float` – tr/min) Nombre de tours de manivelle par minute.

Android

Nom	`com.google.cycling.pedaling.cadence`
Objet de type de données	`TYPE_CYCLING_PEDALING_CADENCE`
Champs (format – unités)	FIELD_RPM (`float` tr/min) Nombre de tours de manivelle par minute.

Cumulatif de pédalage à vélo

Si un utilisateur fait du vélo, ce type de données peut servir à déterminer le nombre de tours de manivelle sur une période donnée. Chaque point de données représente le nombre de tours depuis le décompte à l'heure de début.

REST

Nom	`com.google.cycling.pedaling.cumulative`
Champs d'application des autorisations OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Champs (format—units)	revolutions (`int`—count) Nombre de tours de manivelle de vélo sur une période.

Android

Nom	`com.google.cycling.pedaling.cumulative`
Objet de type de données	`TYPE_CYCLING_PEDALING_CUMULATIVE`
Champs (format—units)	FIELD_REVOLUTIONS (`int` : nombre) Nombre de tours de manivelle de vélo sur une période donnée.

Points cardio

Ce type de données enregistre le nombre de points de cœur qu'un utilisateur a gagnés, à partir de toutes ses activités. Chaque point de données représente le nombre de points de cœur calculés pour un intervalle de temps.

Les utilisateurs peuvent définir un objectif quotidien de points cardio et suivre leurs progrès. Les points de cœur peuvent être calculés comme suit :

fréquence cardiaque
Valeurs de l'équivalent métabolique de la tâche (MET)
vitesse à pied

Le nombre de points cardio gagnés dépend de l'intensité de l'activité. Utilisez ce guide pour calculer et écrire des points cardio:

Données	1 ch (activité faible à moyenne)	2 ch (activité à haute intensité)
Fréquence cardiaque	1 minute d'activité à une fréquence cardiaque supérieure à 50 %	1 minute d'activité à plus de 70 % de la fréquence cardiaque maximale
Valeur MET	3 à 6 MET. Par exemple, l'aviron ou l'escalade,	>6 MET. Par exemple, HIIT, ski, volley-ball ou football.
Vitesse de marche	100 à 130 pas par minute	> 130 pas par minute

REST

Nom	`com.google.heart_minutes`
Champs d'application des autorisations OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Champs (format—units)	intensité (`float` : points cardio) Points cardio gagnés en fonction de l'intensité de l'exercice ou de l'activité de l'utilisateur.

Android

Nom	`com.google.heart_minutes`
Objet de type de données	`TYPE_HEART_MINUTES`
Champs (format – unités)	FIELD_INTENSITY (`float` – points cardiaques) Intensité de l'exercice ou de l'activité de l'utilisateur. Une minute de activité physique légère à modérée (marche à plus de 4 km/h, ou à vélo à plus de 16 km/h) permet de gagner 1 point cardio. Une minute ou plus une activité intense permet de gagner 2 points cardio.

Minutes actives

Ce type de données capture le nombre de minutes actives que Google Fit calcule qu'un de l'utilisateur, grâce à toute son activité. Chaque point de données représente le nombre dérivé de minutes de mouvement pour un intervalle de temps. Vous devez définir une heure de début et une heure de fin.

Les utilisateurs peuvent gagner des minutes de mouvement pour n'importe quelle activité, comme le yoga, la danse, le jardinage et d'autres tâches ménagères. S'il fait une promenade, Google Fit lui attribue une minute de mouvement chaque fois qu'il fait au moins 30 pas en 60 secondes.

REST

Nom	`com.google.active_minutes`
Champs d'application des autorisations OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Champs (format—units)	duration (durée) (`int` – millisecondes) Durée des minutes de mouvement gagnées, en millisecondes. Plage valide : >=0

Android

Nom	`com.google.active_minutes`
Objet de type de données	`TYPE_MOVE_MINUTES`
Champs (format—units)	FIELD_DURATION (`int` : millisecondes) Durée des minutes actives gagnées, en millisecondes. Plage valide : 0 à Long.MAX_VALUE

Alimentation

Ce type de données capture la puissance générée par un utilisateur lorsqu'il effectue une activité, mesurée en watts. Par exemple, l'utilisation d'un compteur de puissance lors d'un exercice sur un vélo d'appartement. Chaque point de données représente une mesure instantanée de d'énergie générée.

Chaque point de données représente une mesure instantanée de la puissance générée. Par conséquent, seule l'heure de fin doit être définie. Il servira de code temporel pour la lecture.

REST

Nom	`com.google.power.sample`
Champs d'application des autorisations OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Champs (format—units)	watts (`float` : watts) Énergie générée, en watts.

Android

Nom	`com.google.power.sample`
Objet de type de données	`TYPE_POWER_SAMPLE`
Champs (format—units)	FIELD_WATTS (`float` – watts) Puissance générée, en watts.

Cadence de comptage des pas

Ce type de données enregistre la cadence de marche, mesurée en pas par minute. Chaque le point de données représente une mesure instantanée de la cadence en pas par minute.

REST

Nom	`com.google.step_count.cadence`
Champs d'application des autorisations OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
Champs (format—units)	rpm (`float` : pas/minute) Cadence mesurée en pas par minute.

Android

Nom	`com.google.step_count.cadence`
Objet de type de données	`TYPE_STEP_COUNT_CADENCE`
Champs (format—units)	FIELD_RPM (`float` – pas/minute) Cadence mesurée en pas par minute.

Delta du nombre de pas

Ce type de données capture le nombre de pas effectués depuis la dernière lecture. Chaque étape n'est enregistrée qu'une seule fois. Par conséquent, les points de données ne doivent pas se chevaucher. L'heure de début de chaque point de données doit représenter le début de l'intervalle au cours duquel des mesures ont été prises.

L'heure de début doit être supérieure ou égale à la date de fin du point de données précédent. En additionnant toutes les valeurs d'une période donnée, vous pouvez calculer le nombre total de pas effectués pendant cette période.

REST

Nom com.google.step_count.delta

Champs d'application des autorisations OAuth

https://www.googleapis.com/auth/fitness.activity.read

https://www.googleapis.com/auth/fitness.activity.write

Champs (format – unités)

steps (int : nombre)

Nombre de pas effectués sur une période donnée.

Plage valide : 0 à 10 pas par seconde

Android

Nom com.google.step_count.delta

Objet de type de données TYPE_STEP_COUNT_DELTA

Autorisation Android ACTIVITY_RECOGNITION

Champs (format—units)

TYPE_STEP_COUNT_DELTA (int : nombre)

Nombre de pas effectués au cours d'une période.

Plage valide : 0 à 10 pas par seconde

Entraînement

Chaque point de données représente un seul ensemble continu d'un exercice d'entraînement par un utilisateur. Le point de données contient des champs pour le type d'exercice (par exemple d'exercices en résistance ou d'entraînement avec poids), le nombre de répétitions de l'exercice, sa durée et la résistance.

REST

Nom com.google.activity.exercise

Champs d'application des autorisations OAuth

https://www.googleapis.com/auth/fitness.activity.read

https://www.googleapis.com/auth/fitness.activity.write

Champs (format—units)

exercice (int : énumération)

Valeurs représentant différents exercices, comme les exercices d'haltérophilie, les exercices de musculation et les exercices cardiovasculaires.

Valeurs acceptées

back_extension
bridge.hip.single_leg
burpee
calf_press
calf_raise
calf_raise.seated
calf_raise.standing
chinup
clean
clean.hang
clean.hang_power
clean.jerk
clean.power
crunch
crunch.twisting
curl.bicep
deadlift
deadlift.rdl
deadlift.single_leg
deadlift.straight_leg
dip
dip.chest
dip.triceps
fly
good_morning
hip_extension
hip_raise
hip_thrust
jumping_jack
leg_curl
leg_extension
leg_press
leg_raise
lunge
lunge.rear
lunge.side
plank
plank.side
press.bench
press.bench.close_grip
press.bench.decline
press.bench.incline
press.jm
press.pike
press.shoulder
press.shoulder.arnold
press.shoulder.military
pulldown
pullover
pullup
pushup
pushup.close_grip
pushup.pike
raise.front
raise.lateral
raise.lateral.rear
row
row.high
row.upright
run.high_knee
russian_twist
shrug
situp
situp.twisting
squat
step_up
swing
thruster
triceps_extension
vups
wall_sit

repetitions (int : énumération)

Nombre de répétitions d'un exercice.

type de résistance (int : énumération)

Type de résistance utilisé pendant l'exercice.

Valeurs acceptées

"intVal": 0 // The resistance type is unknown, unspecified, or can't be represented by a value.
"intVal": 1 // The user is using a barbell for resistance.
"intVal": 2 // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
"intVal": 3 // The user is using dumbells for resistance.
"intVal": 4 // The user is using a kettlebell for resistance
"intVal": 5 // The user is performing the exercise in a machine.
"intVal": 6 // The user is using their own body weight for resistance.

résistance (float—kg)

Résistance de l'exercice (ou poids), en kilogrammes.

duration (int : millisecondes)

Durée d'un exercice pour lequel la durée est importante.

Android

Nom com.google.activity.exercise

Champs (format – unités)

FIELD_EXERCISE (int : énumération)

Valeurs représentant différents exercices, tels que les exercices de musculation, les exercices de renforcement musculaire et les exercices cardiovasculaires.

Valeurs acceptées

ARNOLD_PRESS
BACK_EXTENSION
BENCH_PRESS
BICEP_CURL
BURPEE
CALF_PRESS
CALF_RAISE
CHEST_DIP
CHINUP
CLEAN
CLEAN_JERK
CLOSE_GRIP_BENCH_PRESS
CLOSE_GRIP_PUSHUP
CRUNCH
DEADLIFT
DECLINE_BENCH_PRESS
DIP
FLY
FRONT_RAISE
GOOD_MORNING
HANG_CLEAN
HANG_POWER_CLEAN
HIGH_KNEE_RUN
HIGH_ROW
HIP_EXTENSION
HIP_RAISE
HIP_THRUST
INCLINE_BENCH_PRESS
JM_PRESS
JUMPING_JACK
LATERAL_RAISE
LEG_CURL
LEG_EXTENSION
LEG_PRESS
LEG_RAISE
LUNGE
MILITARY_PRESS
PIKE_PRESS
PIKE_PUSHUP
PLANK
POWER_CLEAN
PULLDOWN
PULLOVER
PULLUP
PUSHUP
RDL_DEADLIFT
REAR_LATERAL_RAISE
REAR_LUNGE
ROW
RUSSIAN_TWIST
SEATED_CALF_RAISE
SHOULDER_PRESS
SHRUG
SIDE_LUNGE
SIDE_PLANK
SINGLE_LEG_DEADLIFT
SINGLE_LEG_HIP_BRIDGE
SITUP
SQUAT
STANDING_CALF_RAISE
STEP_UP
STRAIGHT_LEG_DEADLIFT
SWING
THRUSTER
TRICEPS_DIP
TRICEPS_EXTENSION
TWISTING_CRUNCH
TWISTING_SITUP
UPRIGHT_ROW
V_UPS
WALL_SIT

FIELD_REPETITIONS (int – nombre)

Nombre de répétitions d'un exercice.

FIELD_RESISTANCE_TYPE (int : énumération)

Type de résistance utilisé pendant l'exercice.

Valeurs acceptées

RESISTANCE_TYPE_UNKNOWN // The resistance type is unknown, unspecified, or can't be represented by a value.
RESISTANCE_TYPE_BARBELL // The user is using a barbell for resistance.
RESISTANCE_TYPE_CABLE // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
RESISTANCE_TYPE_DUMBBELL // The user is using dumbells for resistance.
RESISTANCE_TYPE_KETTLEBELL // The user is using a kettlebell for resistance
RESISTANCE_TYPE_MACHINE // The user is performing the exercise in a machine.
RESISTANCE_TYPE_BODY // The user is using their own body weight for resistance.

FIELD_RESISTANCE (float—kg)

Résistance de l'exercice (ou du poids), en kilogrammes.

FIELD_DURATION (int – millisecondes)

Durée d'un exercice dont la durée est importante.