إنّ واجهات برمجة تطبيقات Google Fit، بما في ذلك Google Fit REST API، لن تعود متاحة بعد 30 حزيران (يونيو) 2025. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.

للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة المطلوب نقل البيانات إليها، انتقِل إلى دليل نقل البيانات إلى Health Connect. للمقارنة بين Health Connect وواجهات برمجة تطبيقات Google Fit وواجهات برمجة تطبيقات الويب Fitbit، يُرجى الانتقال إلى دليل المقارنة في Health Connect.

تعرَّف على مزيد من المعلومات حول Health Connect وكيفية الدمج مع واجهة برمجة التطبيقات.

تمت ترجمة هذه الصفحة بواسطة 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`	الرمز المميز للمتابعة، الذي يُستخدم للتنقل عبر مجموعات النتائج الكبيرة. للحصول على الصفحة التالية من النتائج، عيِّن هذه المعلمة على قيمة `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`	قيم كل حقل نوع بيانات لنقطة البيانات من المتوقع أن تحدث كل قيمة متوافقة مع حقل نوع البيانات بالترتيب نفسه الذي يتم إدراج الحقل به في نوع البيانات المحدّد في مصدر البيانات. لن تتم تعبئة سوى حقل واحد من حقول الأعداد الصحيحة والنقاط العائمة، استنادًا إلى قيمة التعداد للتنسيق ضمن حقل نوع مصدر البيانات.
`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`	قيم كل حقل نوع بيانات لنقطة البيانات من المتوقع أن تحدث كل قيمة متوافقة مع حقل نوع البيانات بالترتيب نفسه الذي يتم إدراج الحقل به في نوع البيانات المحدّد في مصدر البيانات. لن تتم تعبئة سوى حقل واحد من حقول الأعداد الصحيحة والنقاط العائمة، استنادًا إلى قيمة التعداد للتنسيق ضمن حقل نوع مصدر البيانات.
`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`	الرمز المميز للمتابعة، الذي يُستخدم للتنقل عبر مجموعات النتائج الكبيرة. قدِّم هذه القيمة في طلب لاحق لعرض الصفحة التالية من النتائج.
`dataSourceId`	`string`	رقم تعريف مصدر البيانات لمصدر البيانات مع تغيير نقاط البيانات.

جرّب الآن

يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.