Users.dataSources.datasets: patch
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Добавляет точки данных в набор данных. Набор данных не обязательно создавать заранее. Все точки в данном наборе данных будут возвращены с последующими вызовами для получения этого набора данных. Точки данных могут принадлежать более чем одному набору данных.
Этот метод не использует семантику исправлений: предоставленные точки данных просто вставляются без замены существующих данных. Попробуйте сейчас .
Запрос
HTTP-запрос
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
Параметры
| Имя параметра | Ценить | Описание |
|---|
| Параметры пути |
dataSourceId | string | Идентификатор потока данных источника данных, создавшего набор данных. |
datasetId | string | Это поле не используется и его можно смело опустить. |
userId | string | Исправьте набор данных для идентифицированного человека. Используйте me , чтобы указать аутентифицированного пользователя. В данный момент поддерживается только me . |
Авторизация
Для этого запроса требуется авторизация хотя бы в одной из следующих областей:
| Объем |
|---|
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 |
Дополнительную информацию см. на странице аутентификации и авторизации .
Тело запроса
В теле запроса укажите соответствующие части ресурса Users.dataSources.datasets в соответствии с правилами семантики исправлений со следующими свойствами:
| Имя свойства | Ценить | Описание | Примечания |
|---|
| Обязательные свойства |
dataSourceId | string | Идентификатор потока данных источника данных, создавшего точки в этом наборе данных. | |
maxEndTimeNs | long | Наибольшее время окончания всех точек данных в этом, возможно, частичном представлении набора данных. Время указывается в наносекундах от эпохи. Это также должно соответствовать второй части идентификатора набора данных. | |
minStartTimeNs | long | Наименьшее время начала всех точек данных в этом, возможно, частичном представлении набора данных. Время указывается в наносекундах от эпохи. Это также должно соответствовать первой части идентификатора набора данных. | |
point[] | list | Частичный список точек данных, содержащихся в наборе данных, упорядоченный по endTimeNanos. Этот список считается полным при получении небольшого набора данных и частичным при исправлении набора данных или получении набора данных, который слишком велик для включения в один ответ. | |
point[]. dataTypeName | string | Тип данных, определяющий формат значений в этой точке данных. | |
point[]. endTimeNanos | long | Время окончания интервала, представленного этой точкой данных, в наносекундах с начала эпохи. | |
point[]. startTimeNanos | long | Время начала интервала, представленного этой точкой данных, в наносекундах с начала эпохи. | |
point[]. value[] | list | Значения каждого поля типа данных для точки данных. Ожидается, что каждое значение, соответствующее полю типа данных, будет встречаться в том же порядке, в котором поле указано в типе данных, указанном в источнике данных.
Будет заполнено только одно из полей целого числа или поля с плавающей запятой, в зависимости от значения перечисления формата в поле типа источника данных.
| |
Попробуйте!
Используйте API-обозреватель ниже, чтобы вызвать этот метод для реальных данных и просмотреть ответ.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 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."]]
