Users.sessions: update

Remarque: Nécessite une autorisation.

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.