APIهای Google Fit، از جمله Google Fit REST API، پس از 30 ژوئن 2025 دیگر در دسترس نخواهند بود . از 1 می 2024، توسعه دهندگان نمی توانند برای استفاده از این API ها ثبت نام کنند .

برای دستورالعمل‌هایی که در مورد کدام API یا پلتفرم باید به آن مهاجرت کنید، از راهنمای مهاجرت Health Connect دیدن کنید. برای مقایسه Health Connect با APIهای Google Fit و APIهای وب Fitbit، از راهنمای مقایسه Health Connect دیدن کنید.

درباره Health Connect و نحوه ادغام با API بیشتر بیاموزید .

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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 زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.