Répertorie les sessions précédemment créées. Essayer maintenant
Requête
Requête HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
Paramètres
Nom du paramètre | Valeur | Description |
---|---|---|
Paramètres de chemin d'accès | ||
userId |
string |
Listez les sessions pour la personne identifiée. Utilisez me pour indiquer l'utilisateur authentifié. Seule la région me est compatible pour le moment.
|
Paramètres de requête facultatifs | ||
activityType |
integer |
Si ce champ n'est pas vide, seules les sessions associées à ces types d'activité doivent être renvoyées. |
endTime |
string |
Un horodatage RFC3339. Seules les sessions se terminant entre les heures de début et de fin seront incluses dans la réponse. Si cette heure est omise, mais que startTime est spécifié, toutes les sessions de startTime à la fin de l'heure sont renvoyées. |
includeDeleted |
boolean |
Si la valeur est "true", et si startTime et endTime sont omis, les suppressions de sessions sont renvoyées. |
pageToken |
string |
Jeton de continuation utilisé pour la synchronisation incrémentielle.
Pour obtenir le lot de modifications suivant, définissez ce paramètre sur la valeur de nextPageToken de la réponse précédente. Le jeton de page est ignoré si une heure de début ou de fin est spécifiée. Si aucune heure de début, aucune heure de fin et aucun jeton de page n'est spécifié, les sessions modifiées au cours des 30 derniers jours sont renvoyées.
|
startTime |
string |
Un horodatage RFC3339. Seules les sessions se terminant entre les heures de début et de fin seront incluses dans la réponse. Si cette heure est omise, mais que endTime est spécifié, toutes les sessions entre le début de l'heure et le endTime sont renvoyées. |
Autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants:
Champ d'application |
---|
https://www.googleapis.com/auth/fitness.activity.read |
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.read |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.read |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.read |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.read |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
Pour en savoir plus, consultez la page Authentification et autorisation.
Corps de la requête
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{ "session": [ { "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long } ], "deletedSession": [ { "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long } ], "nextPageToken": string, "hasMoreData": boolean }
Nom de propriété | Valeur | Description | Remarques |
---|---|---|---|
session[] |
list |
Sessions dont l'heure de fin est comprise entre startTime et endTime de la requête. |
|
session[].id |
string |
Identifiant généré par le client qui est unique pour toutes les sessions appartenant à cet utilisateur spécifique. | |
session[].name |
string |
Nom de session lisible par l'humain. | |
session[].description |
string |
Description de cette session. | |
session[].startTimeMillis |
long |
Heure de début (incluse) en millisecondes depuis l'epoch. | |
session[].endTimeMillis |
long |
Heure de fin, en millisecondes écoulées depuis l'epoch. | |
session[].modifiedTimeMillis |
long |
Code temporel indiquant la date de dernière modification de la session. | |
session[].application |
nested object |
Application qui a créé la session. | |
session[].application.packageName |
string |
Nom de package de cette application. Il est utilisé comme identifiant unique lorsqu'il est créé par les applications Android, mais ne peut pas être spécifié par les clients REST. Le numéro de projet de développeur des clients REST est reflété dans les ID de flux de données de la source de données, au lieu du nom de package. | |
session[].application.version |
string |
Version de l'application. Vous devez mettre à jour ce champ chaque fois que l'application change d'une manière qui affecte le calcul des données. | |
session[].application.detailsUrl |
string |
URI facultatif permettant de renvoyer vers l'application. | |
session[].application.name |
string |
Nom de cette application. Ce nom est obligatoire pour les clients REST, mais nous n'imposons pas l'unicité de ce nom. Il est fourni pour plus de commodité aux autres développeurs qui souhaitent identifier quel REST a créé une application ou une source de données. | |
session[].activityType |
integer |
Type d'activité représenté par cette session. | |
deletedSession[] |
list |
Si includeDeleted est défini sur "true" dans la requête, et si startTime et endTime sont omis, cela inclut les sessions qui ont été supprimées depuis la dernière synchronisation. |
|
deletedSession[].id |
string |
Identifiant généré par le client qui est unique pour toutes les sessions appartenant à cet utilisateur spécifique. | |
deletedSession[].name |
string |
Nom de session lisible par l'humain. | |
deletedSession[].description |
string |
Description de cette session. | |
deletedSession[].startTimeMillis |
long |
Heure de début (incluse) en millisecondes depuis l'epoch. | |
deletedSession[].endTimeMillis |
long |
Heure de fin, en millisecondes écoulées depuis l'epoch. | |
deletedSession[].modifiedTimeMillis |
long |
Code temporel indiquant la date de dernière modification de la session. | |
deletedSession[].application |
nested object |
Application qui a créé la session. | |
deletedSession[].application.packageName |
string |
Nom de package de cette application. Il est utilisé comme identifiant unique lorsqu'il est créé par les applications Android, mais ne peut pas être spécifié par les clients REST. Le numéro de projet de développeur des clients REST est reflété dans les ID de flux de données de la source de données, au lieu du nom de package. | |
deletedSession[].application.version |
string |
Version de l'application. Vous devez mettre à jour ce champ chaque fois que l'application change d'une manière qui affecte le calcul des données. | |
deletedSession[].application.detailsUrl |
string |
URI facultatif permettant de renvoyer vers l'application. | |
deletedSession[].application.name |
string |
Nom de cette application. Ce nom est obligatoire pour les clients REST, mais nous n'imposons pas l'unicité de ce nom. Il est fourni pour plus de commodité aux autres développeurs qui souhaitent identifier quel REST a créé une application ou une source de données. | |
deletedSession[].activityType |
integer |
Type d'activité représenté par cette session. | |
nextPageToken |
string |
Jeton de synchronisation utilisé pour synchroniser d'autres modifications. Il n'est fourni que si startTime et endTime sont omis de la requête. | |
session[].activeTimeMillis |
long |
Durée d'activité de la session. Alors que start_time_millis et end_time_millis définissent la durée complète de la session, la durée d'activité peut être plus courte et spécifiée par active_time_millis. Si le temps d'inactivité au cours de la session est connu, il doit également être inséré via un point de données com.google.activity.segment avec une valeur d'activité STILL |
|
deletedSession[].activeTimeMillis |
long |
Durée d'activité de la session. Alors que start_time_millis et end_time_millis définissent la durée complète de la session, la durée d'activité peut être plus courte et spécifiée par active_time_millis. Si le temps d'inactivité au cours de la session est connu, il doit également être inséré via un point de données com.google.activity.segment avec une valeur d'activité STILL |
|
hasMoreData |
boolean |
Indicateur indiquant que le serveur a plus de données à transférer. N'UTILISEZ PAS CE CHAMP. Il n'est jamais renseigné dans les réponses du serveur. |
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.