Users.dataSources.datasets: patch
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Agrega datos a un conjunto de datos. No es necesario crear el conjunto de datos con anterioridad.
Todos los puntos dentro del conjunto de datos dado se devolverán con las llamadas posteriores.
para recuperar este conjunto de datos. Los datos pueden pertenecer a más de un conjunto de datos.
Este método no usa la semántica de parches: los datos proporcionados son
que simplemente se inserten, sin reemplazar los datos existentes.
Pruébalo ahora.
Solicitud
Solicitud HTTP
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
Parámetros
Nombre del parámetro |
Valor |
Descripción |
Parámetros de ruta de acceso |
dataSourceId |
string |
Es el ID del flujo de datos de la fuente de datos que creó el conjunto de datos.
|
datasetId |
string |
Este campo no se utiliza y se puede omitir de forma segura.
|
userId |
string |
Aplicar parches a un conjunto de datos para la persona identificada Usa me para indicar
el usuario autenticado. En este momento, solo se admite me .
|
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes alcances:
Alcance |
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 |
Para obtener más información, consulta la página de autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona las partes relevantes de un recurso Users.dataSources.datasets, según las reglas de la semántica de parches, con las siguientes propiedades:
Nombre de la propiedad |
Valor |
Descripción |
Notas |
Propiedades obligatorias |
dataSourceId |
string |
Es el ID del flujo de datos de la fuente de datos que creó los puntos en este conjunto de datos. |
|
maxEndTimeNs |
long |
La hora de finalización más grande de todos los datos en esta representación posiblemente parcial del conjunto de datos. El tiempo se calcula en nanosegundos desde el ciclo de entrenamiento. Esto también debe coincidir con la segunda parte del identificador del conjunto de datos. |
|
minStartTimeNs |
long |
El tiempo de inicio más pequeño de todos los datos en esta representación posiblemente parcial del conjunto de datos. El tiempo se calcula en nanosegundos desde el ciclo de entrenamiento. También debe coincidir con la primera parte del identificador del conjunto de datos. |
|
point[] |
list |
Una lista parcial de datos contenidos en el conjunto de datos, ordenados por endTimeNanos. Esta lista se considera completa cuando se recupera un conjunto de datos pequeño y parcial cuando se aplica un parche a un conjunto de datos o se recupera un conjunto de datos que es demasiado grande para incluirlo en una sola respuesta. |
|
point[].dataTypeName |
string |
Es el tipo de datos que define el formato de los valores en este dato. |
|
point[].endTimeNanos |
long |
Es la hora de finalización del intervalo representado por este dato, en nanosegundos desde el ciclo de entrenamiento. |
|
point[].startTimeNanos |
long |
Es la hora de inicio del intervalo representada por este dato, en nanosegundos desde el ciclo de entrenamiento. |
|
point[].value[] |
list |
Valores de cada campo de tipo de datos para el dato. Se espera que cada valor correspondiente a un campo de tipo de datos ocurra en el mismo orden en el que aparece el campo en el tipo de datos especificado en la fuente de datos.
Solo se propagará a uno de los campos de número entero y de punto flotante, según el valor de enumeración del formato en el campo de tipo de la fuente de datos.
|
|
Pruébalo
Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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."]]