Users.dataSources.datasets: patch
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Fügt Datenpunkten zu einem Dataset hinzu. Das Dataset muss nicht zuvor erstellt worden sein.
Alle Punkte innerhalb des angegebenen Datasets werden mit nachfolgenden Aufrufen zurückgegeben.
um dieses Dataset abzurufen. Datenpunkte können zu mehr als einem Dataset gehören.
Diese Methode verwendet keine Patch-Semantik: Die bereitgestellten Datenpunkte sind
nur eingefügt werden, ohne dass vorhandene Daten ersetzt werden.
Jetzt ausprobieren
Anfrage
HTTP-Anfrage
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
Parameter
| Parametername |
Wert |
Beschreibung |
| Pfadparameter |
dataSourceId |
string |
Die Datenstream-ID der Datenquelle, in der das Dataset erstellt wurde.
|
datasetId |
string |
Dieses Feld wird nicht verwendet und kann weggelassen werden.
|
userId |
string |
Ein Dataset für die identifizierte Person patchen. Mit me geben Sie
mit dem authentifizierten Nutzer. Derzeit wird nur me unterstützt.
|
Autorisierung
Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
| Umfang |
|---|
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 |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Geben Sie im Anfragetext die relevanten Teile einer Users.dataSources.datasets-Ressource nach den Regeln der Patch-Semantik mit den folgenden Attributen an:
| Property-Name |
Wert |
Beschreibung |
Hinweise |
| Erforderliche Attribute |
dataSourceId |
string |
Die Datenstream-ID der Datenquelle, über die die Punkte in diesem Dataset erstellt wurden. |
|
maxEndTimeNs |
long |
Die längste Endzeit aller Datenpunkte in dieser möglicherweise Teildarstellung des Datasets. Die Zeit wird in Nanosekunden ab der Epoche angegeben. Er sollte auch mit dem zweiten Teil der Dataset-ID übereinstimmen. |
|
minStartTimeNs |
long |
Die kleinste Startzeit aller Datenpunkte in dieser möglicherweise Teildarstellung des Datasets. Die Zeit wird in Nanosekunden ab der Epoche angegeben. Er sollte auch mit dem ersten Teil der Dataset-ID übereinstimmen. |
|
point[] |
list |
Eine unvollständige Liste der im Dataset enthaltenen Datenpunkte, sortiert nach endTimeNanos. Diese Liste gilt als vollständig, wenn ein kleines Dataset abgerufen wird, und als Teil, wenn ein Dataset gepatcht oder ein Dataset abgerufen wird, das zu groß ist, um es in eine einzelne Antwort aufzunehmen. |
|
point[].dataTypeName |
string |
Der Datentyp, der das Format der Werte in diesem Datenpunkt definiert. |
|
point[].endTimeNanos |
long |
Die Endzeit des durch diesen Datenpunkt dargestellten Intervalls in Nanosekunden seit der Epoche. |
|
point[].startTimeNanos |
long |
Die Startzeit des durch diesen Datenpunkt dargestellten Intervalls in Nanosekunden seit der Epoche. |
|
point[].value[] |
list |
Werte jedes Datentypfelds für den Datenpunkt. Es wird davon ausgegangen, dass alle Werte, die einem Datentypfeld entsprechen, in derselben Reihenfolge auftreten, in der das Feld im Datentyp aufgeführt ist, der in einer Datenquelle angegeben ist.
Nur eines der Felder für Ganzzahl oder Gleitkomma wird ausgefüllt, je nachdem, welcher Formatwert im Typfeld der Datenquelle angegeben wurde.
|
|
Testen!
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
