Users.sessions: list

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.