Users.sessions: update

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 Value 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:

Portée
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 avec 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é Value Description Remarques
id string Identifiant généré par le client et unique pour toutes les sessions appartenant à cet utilisateur.
name string Nom lisible de la session.
description string Description de cette session.
startTimeMillis long Heure de début, en millisecondes depuis l'époque, incluse.
endTimeMillis long Heure de fin, en millisecondes depuis l'époque, incluse.
modifiedTimeMillis long Horodatage indiquant la dernière fois que la session a été modifiée.
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 des applications Android, mais ne peut pas être spécifié par les clients REST. Le numéro de projet du développeur client REST sera reflété dans les ID de flux de données de la source de données plutôt que dans le champ packageName.
application.version string Version de l'application. Vous devez mettre à jour ce champ chaque fois que les modifications apportées à l'application affectent 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. Cette étape est obligatoire pour les clients REST, mais nous n'imposons pas l'unicité de ce nom. Elle est fournie pour faciliter l'identification des développeurs qui souhaitent créer 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 la durée d'inactivité de la session est connue, elle doit également être insérée 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é Value Description Remarques
id string Identifiant généré par le client et unique pour toutes les sessions appartenant à cet utilisateur.
name string Nom lisible de la session.
description string Description de cette session.
startTimeMillis long Heure de début, en millisecondes depuis l'époque, incluse.
endTimeMillis long Heure de fin, en millisecondes depuis l'époque, incluse.
modifiedTimeMillis long Horodatage indiquant la dernière fois que la session a été modifiée.
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 des applications Android, mais ne peut pas être spécifié par les clients REST. Le numéro de projet du développeur client REST sera reflété dans les ID de flux de données de la source de données plutôt que dans le champ packageName.
application.version string Version de l'application. Vous devez mettre à jour ce champ chaque fois que les modifications apportées à l'application affectent 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. Cette étape est obligatoire pour les clients REST, mais nous n'imposons pas l'unicité de ce nom. Elle est fournie pour faciliter l'identification des développeurs qui souhaitent créer 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 la durée d'inactivité de la session est connue, elle doit également être insérée 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.