Users.dataSources.datasets: patch
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menambahkan titik data ke set data. Set data tidak perlu dibuat sebelumnya.
Semua titik dalam set data yang diberikan akan ditampilkan dengan panggilan tambahan
untuk mengambil {i>dataset <i}ini. Titik data dapat dimiliki oleh lebih dari satu {i>dataset<i}.
Metode ini tidak menggunakan semantik patch: titik data yang disediakan adalah
hanya disisipkan, tanpa ada data yang diganti.
Coba sekarang.
Permintaan
Permintaan HTTP
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
Parameter
| Nama parameter |
Nilai |
Deskripsi |
| Parameter jalur |
dataSourceId |
string |
ID aliran data sumber data yang membuat set data.
|
datasetId |
string |
Kolom ini tidak digunakan, dan dapat dihilangkan dengan aman.
|
userId |
string |
Menambahkan patch di kumpulan data untuk orang yang diidentifikasi. Gunakan me untuk menunjukkan
pengguna yang terautentikasi. Saat ini hanya me yang didukung.
|
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut:
| Cakupan |
|---|
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 |
Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.
Isi permintaan
Dalam isi permintaan, berikan bagian yang relevan dari resource Users.dataSources.datasets, sesuai dengan aturan semantik patch, dengan properti berikut:
| Nama properti |
Nilai |
Deskripsi |
Catatan |
| Properti yang Diperlukan |
dataSourceId |
string |
ID aliran data sumber data yang membuat titik dalam set data ini. |
|
maxEndTimeNs |
long |
Waktu berakhir terbesar dari semua titik data dalam kemungkinan representasi parsial dari set data ini. Waktu dalam nanodetik dari epoch. Ini juga harus cocok dengan bagian kedua dari pengidentifikasi {i>dataset<i}. |
|
minStartTimeNs |
long |
Waktu mulai terkecil dari semua titik data dalam kemungkinan representasi parsial dari set data ini. Waktu dalam nanodetik dari epoch. Ini juga harus cocok dengan bagian pertama dari pengidentifikasi {i>dataset<i}. |
|
point[] |
list |
Daftar sebagian titik data yang terdapat dalam set data, diurutkan menurut endTimeNanos. Daftar ini dianggap lengkap saat mengambil set data kecil dan sebagian saat mem-patch set data atau mengambil set data yang terlalu besar untuk disertakan dalam satu respons. |
|
point[].dataTypeName |
string |
Jenis data yang menentukan format nilai dalam titik data ini. |
|
point[].endTimeNanos |
long |
Waktu berakhir interval yang diwakili oleh titik data ini, dalam nanodetik sejak epoch. |
|
point[].startTimeNanos |
long |
Waktu mulai interval yang diwakili oleh titik data ini, dalam nanodetik sejak epoch. |
|
point[].value[] |
list |
Nilai setiap kolom jenis data untuk titik data. Setiap nilai yang sesuai dengan kolom jenis data diharapkan akan muncul dalam urutan yang sama dengan kolom yang dicantumkan di jenis data yang ditentukan di sumber data.
Hanya salah satu kolom bilangan bulat dan kolom floating point yang akan diisi, bergantung pada nilai enum format dalam kolom jenis sumber data.
|
|
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
