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	رقم تعريف مصدر البيانات لمصدر البيانات مع تغييرات نقاط البيانات.

جرِّب هذه الميزة الآن.

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