Users.dataSources.datasets: patch
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Aggiunge punti dati a un set di dati. Non è necessario creare in precedenza il set di dati.
Tutti i punti all'interno del set di dati specificato verranno restituiti con chiamate successive
per recuperare questo set di dati. I punti dati possono appartenere a più di un set di dati.
Questo metodo non utilizza la semantica della patch: i punti dati forniti sono
è stato semplicemente inserito, senza che i dati esistenti vengano sostituiti.
Prova subito.
Richiesta
Richiesta HTTP
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
Parametri
| Nome del parametro |
Valore |
Descrizione |
| Parametri percorso |
dataSourceId |
string |
L'ID stream di dati dell'origine dati che ha creato il set di dati.
|
datasetId |
string |
Questo campo non è utilizzato e può essere omesso in sicurezza.
|
userId |
string |
Applica le patch a un set di dati per la persona identificata. Usa me per indicare
l'utente autenticato. Al momento è supportato solo me.
|
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti:
| Ambito |
|---|
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 |
Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Nel corpo della richiesta, fornisci le parti pertinenti di una risorsa Users.dataSources.datasets, in base alle regole della semantica della patch, con le seguenti proprietà:
| Nome proprietà |
Valore |
Descrizione |
Note |
| Proprietà obbligatorie |
dataSourceId |
string |
L'ID stream di dati dell'origine dati che ha creato i punti in questo set di dati. |
|
maxEndTimeNs |
long |
L'ora di fine più grande di tutti i punti dati in questa rappresentazione probabilmente parziale del set di dati. Il tempo è in nanosecondi dall'epoca. Dovrebbe corrispondere anche alla seconda parte dell'identificatore del set di dati. |
|
minStartTimeNs |
long |
L'ora di inizio più piccola di tutti i punti dati in questa rappresentazione potenzialmente parziale del set di dati. Il tempo è in nanosecondi dall'epoca. Deve corrispondere anche alla prima parte dell'identificatore del set di dati. |
|
point[] |
list |
Un elenco parziale dei punti dati contenuti nel set di dati, ordinati in base a endTimeNanos. Questo elenco è considerato completo quando si recupera un set di dati di piccole dimensioni e parziale durante l'applicazione di patch a un set di dati o quando si recupera un set di dati troppo grande per essere incluso in una singola risposta. |
|
point[].dataTypeName |
string |
Il tipo di dati che definisce il formato dei valori in questo punto dati. |
|
point[].endTimeNanos |
long |
L'ora di fine dell'intervallo rappresentato da questo punto dati, in nanosecondi dall'epoca. |
|
point[].startTimeNanos |
long |
L'ora di inizio dell'intervallo rappresentato da questo punto dati, in nanosecondi dall'epoca. |
|
point[].value[] |
list |
Valori di ogni campo del tipo di dati per il punto dati. È previsto che ogni valore corrispondente a un campo di tipo dati venga generato nello stesso ordine in cui viene elencato il campo nel tipo di dati specificato in un'origine dati.
Verrà compilato solo uno tra i campi con numeri interi e in virgola mobile, a seconda del valore enum del formato all'interno del campo del tipo di origine dati.
|
|
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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."]]
