Users.dataSources.dataPointChanges: list

توجه: نیاز به مجوز دارد.

جستجوهای مربوط به نقطه داده کاربر برای یک منبع داده خاص تغییر می کند. اکنون آن را امتحان کنید .

درخواست

درخواست HTTP

GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/dataPointChanges

مولفه های

نام پارامتر	ارزش	شرح
پارامترهای مسیر
dataSourceId	string	شناسه جریان داده منبع داده ای که مجموعه داده را ایجاد کرده است.
userId	string	نقاط داده را برای شخص شناسایی شده فهرست کنید. از me برای نشان دادن کاربر تایید شده استفاده کنید. در حال حاضر فقط me پشتیبانی می شود.
پارامترهای پرس و جو اختیاری
limit	integer	اگر مشخص شود، بیش از این تعداد زیادی تغییرات نقطه داده در پاسخ گنجانده نخواهد شد.
pageToken	string	توکن Continuation که برای صفحه‌بندی مجموعه‌های نتایج بزرگ استفاده می‌شود. برای دریافت صفحه بعدی نتایج، این پارامتر را روی مقدار nextPageToken از پاسخ قبلی تنظیم کنید.

مجوز

این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:

محدوده
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

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

درخواست بدن

با این روش بدنه درخواستی ارائه نکنید.

واکنش

در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:

{
  "insertedDataPoint": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "deletedDataPoint": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "nextPageToken": string,
  "dataSourceId": string
}

نام ملک	ارزش	شرح	یادداشت
insertedDataPoint[]	list	نقاط داده درج شده برای کاربر.
insertedDataPoint[]. startTimeNanos	long	زمان شروع بازه نشان داده شده توسط این نقطه داده، در نانوثانیه از دوران.
insertedDataPoint[]. endTimeNanos	long	زمان پایان بازه نشان داده شده توسط این نقطه داده، در نانوثانیه از دوران.
insertedDataPoint[]. dataTypeName	string	نوع داده ای که فرمت مقادیر را در این نقطه داده تعیین می کند.
insertedDataPoint[]. originDataSourceId	string	اگر نقطه داده در یک مجموعه داده برای منبع داده مشتق شده وجود داشته باشد، این فیلد با شناسه جریان منبع داده که نقطه داده را در ابتدا ایجاد کرده است پر می شود. اخطار: برای هیچ چیز به جز اشکال زدایی به این فیلد اعتماد نکنید. ارزش این فیلد، اگر اصلاً تنظیم شود، جزییات اجرایی است و تضمینی برای ثابت ماندن آن وجود ندارد.
insertedDataPoint[]. value[]	list	مقادیر هر فیلد نوع داده برای نقطه داده. انتظار می رود که هر مقدار مربوط به یک فیلد نوع داده به همان ترتیبی رخ دهد که فیلد در نوع داده مشخص شده در منبع داده فهرست شده است. فقط یکی از فیلدهای عدد صحیح و ممیز شناور، بسته به مقدار فرمت enum در فیلد نوع منبع داده، پر می شود.
insertedDataPoint[].value[]. intVal	integer	مقدار صحیح وقتی این تنظیم شد، مقادیر دیگر نباید تنظیم شوند.
insertedDataPoint[].value[]. fpVal	double	مقدار ممیز شناور وقتی این تنظیم شد، مقادیر دیگر نباید تنظیم شوند.
insertedDataPoint[].value[]. stringVal	string	مقدار رشته. وقتی این تنظیم شد، مقادیر دیگر نباید تنظیم شوند. رشته ها باید تا حد امکان کوچک نگه داشته شوند. جریانهای داده با مقادیر رشته ای بزرگ و فرکانس داده بالا ممکن است نمونه برداری شوند.
insertedDataPoint[].value[]. mapVal[]	list	ارزش نقشه فضای کلید و واحدهای معتبر برای مقدار متناظر هر ورودی باید به عنوان بخشی از تعریف نوع داده مستند شود. کلیدها باید تا حد امکان کوچک نگه داشته شوند. جریانهای داده با کلیدهای بزرگ و فرکانس داده بالا ممکن است نمونه برداری شوند.
insertedDataPoint[].value[].mapVal[]. key	string
insertedDataPoint[].value[].mapVal[]. value	nested object
insertedDataPoint[].value[].mapVal[].value. fpVal	double	مقدار ممیز شناور
insertedDataPoint[]. modifiedTimeMillis	long	آخرین باری را که این نقطه داده اصلاح شده را نشان می دهد. فقط در زمینه هایی که تغییرات داده ها را فهرست می کنیم، به جای نمایش وضعیت فعلی داده ها مفید است.
insertedDataPoint[]. rawTimestampNanos	long	مهر زمانی خام از SensorEvent اصلی.
insertedDataPoint[]. computationTimeMillis	long	از این فیلد استفاده نکنید. نادیده گرفته می شود و ذخیره نمی شود.
deletedDataPoint[]	list	نقاط داده حذف شده برای کاربر. توجه داشته باشید، برای اصلاحات، این باید قبل از مدیریت درج‌ها تجزیه شود.
deletedDataPoint[]. startTimeNanos	long	زمان شروع بازه نشان داده شده توسط این نقطه داده، در نانوثانیه از دوران.
deletedDataPoint[]. endTimeNanos	long	زمان پایان بازه نشان داده شده توسط این نقطه داده، در نانوثانیه از دوران.
deletedDataPoint[]. dataTypeName	string	نوع داده ای که فرمت مقادیر را در این نقطه داده تعیین می کند.
deletedDataPoint[]. originDataSourceId	string	اگر نقطه داده در یک مجموعه داده برای منبع داده مشتق شده وجود داشته باشد، این فیلد با شناسه جریان منبع داده که نقطه داده را در ابتدا ایجاد کرده است پر می شود. اخطار: برای هیچ چیز به جز اشکال زدایی به این فیلد اعتماد نکنید. ارزش این فیلد، اگر اصلاً تنظیم شود، جزییات اجرایی است و تضمینی برای ثابت ماندن آن وجود ندارد.
deletedDataPoint[]. value[]	list	مقادیر هر فیلد نوع داده برای نقطه داده. انتظار می رود که هر مقدار مربوط به یک فیلد نوع داده به همان ترتیبی رخ دهد که فیلد در نوع داده مشخص شده در منبع داده فهرست شده است. فقط یکی از فیلدهای عدد صحیح و ممیز شناور، بسته به مقدار فرمت enum در فیلد نوع منبع داده، پر می شود.
deletedDataPoint[].value[]. intVal	integer	مقدار صحیح وقتی این تنظیم شد، مقادیر دیگر نباید تنظیم شوند.
deletedDataPoint[].value[]. fpVal	double	مقدار ممیز شناور وقتی این تنظیم شد، مقادیر دیگر نباید تنظیم شوند.
deletedDataPoint[].value[]. stringVal	string	مقدار رشته. وقتی این تنظیم شد، مقادیر دیگر نباید تنظیم شوند. رشته ها باید تا حد امکان کوچک نگه داشته شوند. جریانهای داده با مقادیر رشته ای بزرگ و فرکانس داده بالا ممکن است نمونه برداری شوند.
deletedDataPoint[].value[]. mapVal[]	list	ارزش نقشه فضای کلید و واحدهای معتبر برای مقدار متناظر هر ورودی باید به عنوان بخشی از تعریف نوع داده مستند شود. کلیدها باید تا حد امکان کوچک نگه داشته شوند. جریانهای داده با کلیدهای بزرگ و فرکانس داده بالا ممکن است نمونه برداری شوند.
deletedDataPoint[].value[].mapVal[]. key	string
deletedDataPoint[].value[].mapVal[]. value	nested object
deletedDataPoint[].value[].mapVal[].value. fpVal	double	مقدار ممیز شناور
deletedDataPoint[]. modifiedTimeMillis	long	آخرین باری را که این نقطه داده اصلاح شده را نشان می دهد. فقط در زمینه هایی که تغییرات داده ها را فهرست می کنیم، به جای نمایش وضعیت فعلی داده ها مفید است.
deletedDataPoint[]. rawTimestampNanos	long	مهر زمانی خام از SensorEvent اصلی.
deletedDataPoint[]. computationTimeMillis	long	از این فیلد استفاده نکنید. نادیده گرفته می شود و ذخیره نمی شود.
nextPageToken	string	توکن Continuation که برای صفحه‌بندی مجموعه‌های نتایج بزرگ استفاده می‌شود. این مقدار را در یک درخواست بعدی برای بازگرداندن صفحه بعدی نتایج ارائه کنید.
dataSourceId	string	شناسه جریان داده منبع داده با نقطه داده تغییر می کند.

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

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