Users.dataSources.datasets: patch
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir veri kümesine veri noktaları ekler. Veri kümesinin daha önce oluşturulması gerekmez.
Belirtilen veri kümesindeki tüm noktalar sonraki çağrılarla döndürülür
kullanabilirsiniz. Veri noktaları, birden fazla veri kümesine ait olabilir.
Bu yöntem yama semantiğini kullanmaz: Sağlanan veri noktaları
mevcut verilerin değiştirilmediğinden emin olun.
Hemen deneyin.
İstek
HTTP isteği
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
Parametreler
| Parametre adı |
Değer |
Açıklama |
| Yol parametreleri |
dataSourceId |
string |
Veri kümesini oluşturan veri kaynağının veri akışı kimliği.
|
datasetId |
string |
Bu alan kullanılmaz ve güvenli bir şekilde atlanabilir.
|
userId |
string |
Tanımlanan kişi için bir veri kümesine yama uygulayın. Belirtmek için me kullanın
kimlik doğrulaması yapılmış olmalıdır. Şu anda yalnızca me desteklenmektedir.
|
Yetkilendirme
Bu istek, aşağıdaki kapsamların en az biriyle yetkilendirme gerektiriyor:
| Kapsam |
|---|
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 |
Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atın.
İstek içeriği
İstek gövdesinde, yama semantiği kurallarına göre Users.dataSources.Veri kümeleri kaynağının ilgili bölümlerini aşağıdaki özelliklerle sağlayın:
| Mülk adı |
Değer |
Açıklama |
Notlar |
| Zorunlu Özellikler |
dataSourceId |
string |
Bu veri kümesindeki noktaları oluşturan veri kaynağının veri akışı kimliği. |
|
maxEndTimeNs |
long |
Veri kümesinin bu muhtemelen kısmi gösterimindeki tüm veri noktalarının en büyük bitiş zamanı. Zaman, dönemden itibaren nanosaniye cinsindendir. Bu, veri kümesi tanımlayıcısının ikinci kısmıyla da eşleşmelidir. |
|
minStartTimeNs |
long |
Veri kümesinin bu muhtemelen kısmi gösterimindeki tüm veri noktalarının en kısa başlangıç zamanı. Zaman, dönemden itibaren nanosaniye cinsindendir. Bu değer, veri kümesi tanımlayıcısının ilk kısmıyla da eşleşmelidir. |
|
point[] |
list |
Veri kümesinde bulunan veri noktalarının, endTimeNanos'a göre sıralanmış kısmi bir listesi. Bu liste, küçük bir veri kümesi alınırken, bir veri kümesine yama uygulanırken veya tek bir yanıta dahil edilemeyecek kadar büyük bir veri kümesi alınırken kısmi olarak kabul edilir. |
|
point[].dataTypeName |
string |
Bu veri noktasındaki değerlerin biçimini belirleyen veri türü. |
|
point[].endTimeNanos |
long |
Dönemden bu yana geçen nanosaniye cinsinden, bu veri noktasının temsil ettiği aralığın bitiş zamanı. |
|
point[].startTimeNanos |
long |
Dönemden bu yana geçen nanosaniye cinsinden, bu veri noktasının temsil ettiği aralığın başlangıç zamanı. |
|
point[].value[] |
list |
Veri noktası için her veri türü alanının değerleri. Bir veri türü alanına karşılık gelen her değerin, alanın veri kaynağında belirtilen veri türünde listelendiği aynı sırayla gerçekleşmesi beklenir.
Veri kaynağının tür alanındaki biçim sıralaması değerine bağlı olarak, tam sayı ve kayan nokta alanlarından yalnızca biri doldurulur.
|
|
Deneyin!
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
