Users.sessions: update

Met à jour ou insérer une session donnée. Essayer maintenant

Requête

Requête HTTP

PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
sessionId string ID de la session à créer.
userId string Créez des sessions pour la personne identifiée. Utilisez me pour indiquer l'utilisateur authentifié. Seule la région me est compatible pour le moment.

Autorisation

Cette requête nécessite une autorisation ayant le champ d'application suivant:

Champ d'application
https://www.googleapis.com/auth/fitness.activity.write

Pour en savoir plus, consultez la page Authentification et autorisation.

Corps de la requête

Dans le corps de la requête, fournissez les données selon la structure suivante:

{
  "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
}
Nom de propriété Valeur Description Remarques
id string Identifiant généré par le client, qui est unique parmi toutes les sessions appartenant à cet utilisateur spécifique.
name string Nom de la session lisible par l'humain.
description string Description de cette session.
startTimeMillis long Heure de début incluse, exprimée en millisecondes depuis l'epoch.
endTimeMillis long Heure de fin (incluse), en millisecondes depuis l'epoch.
modifiedTimeMillis long Horodatage indiquant la date et l'heure de la dernière modification de la session.
application nested object Application qui a créé la 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.
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.
application.detailsUrl string URI facultatif pouvant être utilisé pour créer un lien vers l'application.
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.
activityType integer Type d'activité représenté par cette 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

.

Réponse

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

{
  "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
}
Nom de propriété Valeur Description Remarques
id string Identifiant généré par le client, qui est unique parmi toutes les sessions appartenant à cet utilisateur spécifique.
name string Nom de la session lisible par l'humain.
description string Description de cette session.
startTimeMillis long Heure de début incluse, exprimée en millisecondes depuis l'epoch.
endTimeMillis long Heure de fin (incluse), en millisecondes depuis l'epoch.
modifiedTimeMillis long Horodatage indiquant la date et l'heure de la dernière modification de la session.
application nested object Application qui a créé la 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.
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.
application.detailsUrl string URI facultatif pouvant être utilisé pour créer un lien vers l'application.
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.
activityType integer Type d'activité représenté par cette 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

.

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.