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 مقادیر هر فیلد نوع داده برای نقطه داده. انتظار می رود که هر مقدار مربوط به یک فیلد نوع داده به همان ترتیبی رخ دهد که فیلد در نوع داده مشخص شده در منبع داده فهرست شده است.

فقط یکی از فیلدهای عدد صحیح و ممیز شناور، بسته به مقدار فرمت enum در فیلد نوع منبع داده، پر می شود.

پاسخ

در صورت موفقیت آمیز بودن، این روش یک منبع Users.dataSources.datasets را در بدنه پاسخ برمی گرداند.

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.