نقاط داده را به یک مجموعه داده اضافه می کند. لازم نیست مجموعه داده قبلاً ایجاد شود. تمام نقاط در مجموعه داده داده شده با فراخوانی های بعدی برای بازیابی این مجموعه داده بازگردانده می شود. نقاط داده می توانند به بیش از یک مجموعه داده تعلق داشته باشند.
این روش از معناشناسی وصله استفاده نمی کند: نقاط داده ارائه شده صرفاً درج می شوند و هیچ داده موجود جایگزین نمی شود. اکنون آن را امتحان کنید .
درخواست
درخواست 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 | مقادیر هر فیلد نوع داده برای نقطه داده. انتظار می رود که هر مقدار مربوط به یک فیلد نوع داده به همان ترتیبی رخ دهد که فیلد در نوع داده مشخص شده در منبع داده فهرست شده است. فقط یکی از فیلدهای عدد صحیح و ممیز شناور، بسته به مقدار فرمت enum در فیلد نوع منبع داده، پر می شود. | |
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع Users.dataSources.datasets را در بدنه پاسخ برمی گرداند.
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.