Met à jour ou insère 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 des données en respectant 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 pour toutes les sessions appartenant à cet utilisateur spécifique. | |
name |
string |
Nom de session lisible par l'humain. | |
description |
string |
Description de cette session. | |
startTimeMillis |
long |
Heure de début (incluse) en millisecondes depuis l'epoch. | |
endTimeMillis |
long |
Heure de fin, en millisecondes écoulées depuis l'epoch. | |
modifiedTimeMillis |
long |
Code temporel indiquant la date de dernière modification de la session. | |
application |
nested object |
Application qui a créé la 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. | |
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. | |
application.detailsUrl |
string |
URI facultatif permettant de renvoyer vers l'application. | |
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. | |
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 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 |
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 pour toutes les sessions appartenant à cet utilisateur spécifique. | |
name |
string |
Nom de session lisible par l'humain. | |
description |
string |
Description de cette session. | |
startTimeMillis |
long |
Heure de début (incluse) en millisecondes depuis l'epoch. | |
endTimeMillis |
long |
Heure de fin, en millisecondes écoulées depuis l'epoch. | |
modifiedTimeMillis |
long |
Code temporel indiquant la date de dernière modification de la session. | |
application |
nested object |
Application qui a créé la 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. | |
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. | |
application.detailsUrl |
string |
URI facultatif permettant de renvoyer vers l'application. | |
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. | |
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 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 |
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.