Users.dataSources.datasets: patch
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Adiciona pontos de dados a um conjunto de dados. O conjunto de dados não precisa ter sido criado anteriormente.
Todos os pontos no conjunto de dados determinado serão retornados com chamadas subsequentes
para recuperar esse conjunto de dados. Os pontos de dados podem pertencer a mais de um conjunto de dados.
Esse método não usa semântica de patch: os pontos de dados fornecidos são
simplesmente inseridos, sem nenhum dado existente substituído.
Faça um teste agora.
Solicitação
Solicitação HTTP
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
Parâmetros
| Nome do parâmetro |
Valor |
Descrição |
| Parâmetros de caminho |
dataSourceId |
string |
O ID do fluxo de dados da fonte de dados que criou o conjunto de dados.
|
datasetId |
string |
Este campo não é usado e pode ser omitido com segurança.
|
userId |
string |
Corrija um conjunto de dados para a pessoa identificada. Use me para indicar
o usuário autenticado. Somente me é compatível no momento.
|
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos:
| Escopo |
|---|
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 mais informações, consulte a página de autenticação e autorização.
Corpo da solicitação
No corpo da solicitação, informe as partes relevantes de um recurso Users.dataSources.datasets, de acordo com as regras de semântica de patch, com estas propriedades:
| Nome da propriedade |
Valor |
Descrição |
Observações |
| Propriedades obrigatórias |
dataSourceId |
string |
O ID do fluxo de dados da fonte de dados que criou os pontos neste conjunto de dados. |
|
maxEndTimeNs |
long |
O maior horário de término de todos os pontos de dados nessa representação possivelmente parcial do conjunto de dados. O horário é expresso em nanossegundos a partir da época. Ele também precisa corresponder à segunda parte do identificador do conjunto de dados. |
|
minStartTimeNs |
long |
O menor horário de início de todos os pontos de dados nessa representação possivelmente parcial do conjunto de dados. O horário é expresso em nanossegundos a partir da época. Ele também precisa corresponder à primeira parte do identificador do conjunto de dados. |
|
point[] |
list |
Uma lista parcial de pontos de dados contidos no conjunto de dados, ordenados por endTimeNanos. Essa lista é considerada completa na recuperação de um conjunto de dados pequeno e parcial na correção de um conjunto de dados ou na recuperação de um conjunto de dados muito grande para ser incluído em uma única resposta. |
|
point[].dataTypeName |
string |
O tipo de dados que define o formato dos valores neste ponto de dados. |
|
point[].endTimeNanos |
long |
O horário de término do intervalo representado por esse ponto de dados, em nanossegundos, desde o período. |
|
point[].startTimeNanos |
long |
O horário de início do intervalo representado por esse ponto de dados, em nanossegundos, desde o período. |
|
point[].value[] |
list |
Valores de cada campo de tipo de dados para o ponto de dados. Espera-se que cada valor correspondente a um campo de tipo de dados ocorra na mesma ordem em que o campo está listado no tipo de dados especificado em uma fonte de dados.
Somente um dos campos de número inteiro e de ponto flutuante será preenchido, dependendo do valor do formato enum no campo de tipo da fonte de dados.
|
|
Confira!
Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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."]]
