Users.dataSources.datasets: patch
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ajoute des points de données à un ensemble de données. L'ensemble de données n'a pas besoin d'être créé précédemment.
Tous les points dans l'ensemble de données donné sont renvoyés avec les appels suivants
pour récupérer cet ensemble de données. Les points de données peuvent appartenir à plusieurs ensembles de données.
Cette méthode n'utilise pas la sémantique patch: les points de données fournis sont
simplement insérées, sans remplacer les données existantes.
Essayer maintenant
Requête
Requête HTTP
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
Paramètres
| Nom du paramètre |
Valeur |
Description |
| Paramètres de chemin d'accès |
dataSourceId |
string |
ID du flux de données de la source de données qui a créé l'ensemble de données.
|
datasetId |
string |
Ce champ n'est pas utilisé et peut être omis en toute sécurité.
|
userId |
string |
Appliquer un correctif à un ensemble de données pour la personne identifiée Utilisez me pour indiquer
l'utilisateur authentifié. Seule la région me est compatible pour le moment.
|
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.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
Pour en savoir plus, consultez la page Authentification et autorisation.
Corps de la requête
Dans le corps de la requête, indiquez les parties pertinentes d'une ressource "Users.dataSources.datasets", conformément aux règles de la sémantique "patch", avec les propriétés suivantes:
| Nom de propriété |
Valeur |
Description |
Remarques |
| Propriétés obligatoires |
dataSourceId |
string |
ID du flux de données de la source de données qui a créé les points dans cet ensemble de données. |
|
maxEndTimeNs |
long |
Heure de fin la plus élevée de tous les points de données dans cette représentation peut-être partielle de l'ensemble de données. Le temps est exprimé en nanosecondes à partir de l'epoch. Il doit également correspondre à la deuxième partie de l'identifiant de l'ensemble de données. |
|
minStartTimeNs |
long |
Heure de début la plus petite de tous les points de données dans cette représentation peut-être partielle de l'ensemble de données. Le temps est exprimé en nanosecondes à partir de l'epoch. Il doit également correspondre à la première partie de l'identifiant de l'ensemble de données. |
|
point[] |
list |
Liste partielle des points de données contenus dans l'ensemble de données, triés par endTimeNanos. Cette liste est considérée comme complète lors de la récupération d'un petit ensemble de données, et partielle lors de l'application de correctifs à un ensemble de données ou de la récupération d'un ensemble de données trop volumineux pour être inclus dans une seule réponse. |
|
point[].dataTypeName |
string |
Type de données définissant le format des valeurs dans ce point de données. |
|
point[].endTimeNanos |
long |
Heure de fin de l'intervalle représenté par ce point de données, en nanosecondes depuis l'epoch. |
|
point[].startTimeNanos |
long |
Heure de début de l'intervalle représenté par ce point de données, en nanosecondes depuis l'epoch. |
|
point[].value[] |
list |
Valeurs de chaque champ de type de données pour le point de données. Chaque valeur correspondant à un champ de type de données doit normalement apparaître dans l'ordre dans lequel le champ est répertorié dans le type de données spécifié dans une source de données.
Un seul des champs de type entier et à virgule flottante sera renseigné, selon la valeur d'énumération du format dans le champ de type de la source de données.
|
|
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eAdds data points to a new or existing dataset within Google Fit, returning all dataset points upon retrieval.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes an insert-only approach, without replacing pre-existing data.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes, such as \u003ccode\u003ehttps://www.googleapis.com/auth/fitness.activity.write\u003c/code\u003e, for data access.\u003c/p\u003e\n"],["\u003cp\u003eThe request body necessitates properties like \u003ccode\u003edataSourceId\u003c/code\u003e, \u003ccode\u003emaxEndTimeNs\u003c/code\u003e, \u003ccode\u003eminStartTimeNs\u003c/code\u003e, and an array of data points (\u003ccode\u003epoint[]\u003c/code\u003e) with corresponding values.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a \u003ccode\u003eUsers.dataSources.datasets\u003c/code\u003e resource containing the updated dataset information.\u003c/p\u003e\n"]]],[],null,["# Users.dataSources.datasets: patch\n\n| **Note:** Requires [authorization](#auth).\n\nAdds data points to a dataset. The dataset need not be previously created.\nAll points within the given dataset will be returned with subsquent calls\nto retrieve this dataset. Data points can belong to more than one dataset.\n\n\u003cbr /\u003e\n\n\nThis method does not use patch semantics: the data points provided are\nmerely inserted, with no existing data replaced.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `dataSourceId` | `string` | The data stream ID of the data source that created the dataset. |\n| `datasetId` | `string` | This field is not used, and can be safely omitted. |\n| `userId` | `string` | Patch a dataset for the person identified. Use `me` to indicate the authenticated user. Only `me` is supported at this time. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|---------------------------------------------------------------------|\n| `https://www.googleapis.com/auth/fitness.activity.write` |\n| `https://www.googleapis.com/auth/fitness.location.write` |\n| `https://www.googleapis.com/auth/fitness.body.write` |\n| `https://www.googleapis.com/auth/fitness.nutrition.write` |\n| `https://www.googleapis.com/auth/fitness.blood_pressure.write` |\n| `https://www.googleapis.com/auth/fitness.blood_glucose.write` |\n| `https://www.googleapis.com/auth/fitness.oxygen_saturation.write` |\n| `https://www.googleapis.com/auth/fitness.body_temperature.write` |\n| `https://www.googleapis.com/auth/fitness.reproductive_health.write` |\n\nFor more information, see the [authentication and authorization](/fit/rest/v1/authorization) page.\n\n### Request body\n\nIn the request body, supply the relevant portions of a [Users.dataSources.datasets resource](/fit/rest/v1/reference/users/dataSources/datasets#resource), according to the rules of patch semantics, with the following properties:\n\n| Property name | Value | Description | Notes |\n|--------------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| **Required Properties** ||||\n| `dataSourceId` | `string` | The data stream ID of the data source that created the points in this dataset. | |\n| `maxEndTimeNs` | `long` | The largest end time of all data points in this possibly partial representation of the dataset. Time is in nanoseconds from epoch. This should also match the second part of the dataset identifier. | |\n| `minStartTimeNs` | `long` | The smallest start time of all data points in this possibly partial representation of the dataset. Time is in nanoseconds from epoch. This should also match the first part of the dataset identifier. | |\n| `point[]` | `list` | A partial list of data points contained in the dataset, ordered by endTimeNanos. This list is considered complete when retrieving a small dataset and partial when patching a dataset or retrieving a dataset that is too large to include in a single response. | |\n| point[].`dataTypeName` | `string` | The data type defining the format of the values in this data point. | |\n| point[].`endTimeNanos` | `long` | The end time of the interval represented by this data point, in nanoseconds since epoch. | |\n| point[].`startTimeNanos` | `long` | The start time of the interval represented by this data point, in nanoseconds since epoch. | |\n| point[].`value[]` | `list` | Values of each data type field for the data point. It is expected that each value corresponding to a data type field will occur in the same order that the field is listed with in the data type specified in a data source. Only one of integer and floating point fields will be populated, depending on the format enum value within data source's type field. | |\n\nResponse\n--------\n\nIf successful, this method returns a [Users.dataSources.datasets resource](/fit/rest/v1/reference/users/dataSources/datasets#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
