Users.sessions: list

Liste les sessions créées précédemment. 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 de 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 correspondant à ces types d'activités doivent être renvoyées.
endTime string Un code temporel 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 toutes les sessions du startTime à la fin être renvoyé.
includeDeleted boolean Si "true", et si startTime et endTime sont tous les deux 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ée si une heure de début ou de fin est spécifiée. Si aucune de l'heure de début, de fin et que le jeton de page est spécifié, les sessions modifiées au cours des 30 jours sont retournés.
startTime string Un code temporel 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 et le endTime seront renvoyé.

Autorisation

Une autorisation est requise pour cette demande. 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 parmi toutes les sessions appartenant à cet utilisateur spécifique.
session[].name string Nom de la session lisible par l'humain.
session[].description string Description de cette session.
session[].startTimeMillis long Heure de début incluse, exprimée en millisecondes depuis l'epoch.
session[].endTimeMillis long Heure de fin (incluse), en millisecondes depuis l'epoch.
session[].modifiedTimeMillis long Horodatage indiquant la date et l'heure de la dernière modification de la session.
session[].application nested object Application qui a créé la session.
session[].application.packageName string Nom du 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. Pour les clients REST, le numéro de leur projet de développeur est reflété dans les ID des flux de données de la source de données, au lieu du nom du package.
session[].application.version string Version de l'application. Vous devez mettre à jour ce champ chaque fois que l'application change d'une façon qui affecte le calcul des données.
session[].application.detailsUrl string URI facultatif pouvant être utilisé pour créer un lien vers l'application.
session[].application.name string Nom de cette application. Ce nom est obligatoire pour les clients REST, mais nous n'appliquons pas l'unicité de ce nom. Elle est fournie à des fins de commodité pour les 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 que startTime et endTime sont omis, les sessions supprimées depuis la dernière synchronisation sont incluses.
deletedSession[].id string Identifiant généré par le client, qui est unique parmi toutes les sessions appartenant à cet utilisateur spécifique.
deletedSession[].name string Nom de la session lisible par l'humain.
deletedSession[].description string Description de cette session.
deletedSession[].startTimeMillis long Heure de début incluse, exprimée en millisecondes depuis l'epoch.
deletedSession[].endTimeMillis long Heure de fin (incluse), en millisecondes depuis l'epoch.
deletedSession[].modifiedTimeMillis long Horodatage indiquant la date et l'heure de la dernière modification de la session.
deletedSession[].application nested object Application qui a créé la session.
deletedSession[].application.packageName string Nom du 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. Pour les clients REST, le numéro de leur projet de développeur est reflété dans les ID des flux de données de la source de données, au lieu du nom du package.
deletedSession[].application.version string Version de l'application. Vous devez mettre à jour ce champ chaque fois que l'application change d'une façon qui affecte le calcul des données.
deletedSession[].application.detailsUrl string URI facultatif pouvant être utilisé pour créer un lien vers l'application.
deletedSession[].application.name string Nom de cette application. Ce nom est obligatoire pour les clients REST, mais nous n'appliquons pas l'unicité de ce nom. Elle est fournie à des fins de commodité pour les 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 les modifications ultérieures. Cet élément 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 vous connaissez la durée d'inactivité au cours de la session, vous devez également l'insérer via un point de données "com.google.activity.segment" avec la 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 vous connaissez la durée d'inactivité au cours de la session, vous devez également l'insérer via un point de données "com.google.activity.segment" avec la valeur d'activité STILL

.
hasMoreData boolean Indicateur pour indiquer 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.