Users.dataSources.datasets: patch
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפונקציה מוסיפה נקודות נתונים למערך נתונים. אין צורך ליצור את מערך הנתונים קודם.
כל הנקודות במערך הנתונים הנתונים יוחזרו עם הקריאות הבאות
כדי לאחזר את מערך הנתונים הזה. נקודות על הגרף יכולות להשתייך ליותר ממערך נתונים אחד.
השיטה הזו לא משתמשת בסמנטיקה של תיקונים: נקודות הנתונים שסופקו
רק הוכנסו, ולא הוחלפו נתונים קיימים.
רוצים לנסות עכשיו?
בקשה
בקשת HTTP
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
פרמטרים
| שם הפרמטר |
ערך |
תיאור |
| פרמטרים של נתיב |
dataSourceId |
string |
מזהה מקור הנתונים של מקור הנתונים שיצר את מערך הנתונים.
|
datasetId |
string |
השדה הזה לא בשימוש וניתן להשמיט אותו בבטחה.
|
userId |
string |
מתקנים מערך נתונים בשביל האדם שזוהה. צריך להשתמש ב-me כדי לציין
המשתמש המאומת. כרגע יש תמיכה רק ב-me.
|
אישור
הבקשה הזו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים:
| היקף |
|---|
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 |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מציינים את החלקים הרלוונטיים של משאב Users.dataSources.datasets, בהתאם לכללי סמנטיקה של תיקון, עם המאפיינים הבאים:
| שם הנכס |
ערך |
תיאור |
הערות |
| המאפיינים הנדרשים |
dataSourceId |
string |
מזהה מקור הנתונים של מקור הנתונים שיצר את הנקודות במערך הנתונים הזה. |
|
maxEndTimeNs |
long |
שעת הסיום הגדולה ביותר של כל נקודות הנתונים בייצוג החלקי הזה של מערך הנתונים. הזמן הוא בננו-שניות מתחילת התקופה. הוא צריך להתאים גם לחלק השני של מזהה מערך הנתונים. |
|
minStartTimeNs |
long |
שעת ההתחלה הקצרה ביותר של כל נקודות הנתונים בייצוג החלקי הזה של מערך הנתונים. הזמן הוא בננו-שניות מתחילת התקופה. הוא צריך להתאים גם לחלק הראשון של מזהה מערך הנתונים. |
|
point[] |
list |
רשימה חלקית של נקודות נתונים שכלולות במערך הנתונים, ממוינות לפי endTimeNanos. הרשימה הזו נחשבת כהושלמה באחזור מערך נתונים קטן וחלקיתי כשמתקנים מערך נתונים או מאחזרים מערך נתונים שגדול מדי ולא ניתן לכלול אותו בתגובה אחת. |
|
point[].dataTypeName |
string |
סוג הנתונים שמגדיר את הפורמט של הערכים בנקודת הנתונים הזו. |
|
point[].endTimeNanos |
long |
זמן הסיום של המרווח שמיוצג על ידי נקודת הנתונים הזו, בננו-שניות מאז תחילת התקופה. |
|
point[].startTimeNanos |
long |
שעת ההתחלה של המרווח שמיוצג על ידי נקודת הנתונים הזו, בננו-שניות מאז תחילת התקופה. |
|
point[].value[] |
list |
הערכים של כל שדה בסוג הנתונים של הנקודה על הגרף. מצופה שכל ערך שתואם לשדה של סוג הנתונים יופיע באותו סדר שבו השדה מופיע בסוג הנתונים שצוין במקור הנתונים.
רק אחד מהשדות של מספרים שלמים ונקודה צפה (floating-point) יאוכלס, בהתאם לפורמט enum שבשדה הסוג של מקור הנתונים.
|
|
נסה בעצמך!
אפשר להשתמש ב-APIs Explorer שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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."]]
