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، وفقًا لقواعد دلالات التصحيح، مع الخصائص التالية:

اسم الموقع القيمة الوصف Notes
الخصائص المطلوبة
dataSourceId string رقم تعريف مصدر البيانات لمصدر البيانات الذي أنشأ النقاط في مجموعة البيانات هذه.
maxEndTimeNs long أكبر وقت انتهاء لجميع نقاط البيانات في هذا التمثيل الجزئي الذي ربما يتم تمثيله لمجموعة البيانات. الوقت بالنانوثانية من الفترة. يجب أن يتطابق هذا أيضًا مع الجزء الثاني من معرّف مجموعة البيانات.
minStartTimeNs long أصغر وقت بدء لجميع نقاط البيانات في هذا التمثيل الجزئي المحتمل لمجموعة البيانات. الوقت بالنانوثانية من الفترة. ويجب أن يتطابق هذا أيضًا مع الجزء الأول من معرّف مجموعة البيانات.
point[] list قائمة جزئية بنقاط البيانات المضمنة في مجموعة البيانات، مرتبة حسب endTimeNanos. تعتبر هذه القائمة كاملة عند استرداد مجموعة بيانات صغيرة وجزئية عند تصحيح مجموعة بيانات أو استرداد مجموعة بيانات كبيرة جدًا بحيث لا يمكن تضمينها في إجابة واحدة.
point[].dataTypeName string تمثّل هذه السمة نوع البيانات الذي يحدّد تنسيق القيم في نقطة البيانات هذه.
point[].endTimeNanos long وقت انتهاء الفاصل الزمني الذي تمثله نقطة البيانات هذه، بالنانو ثانية منذ تاريخ بدء حساب الفترة.
point[].startTimeNanos long وقت بدء الفاصل الزمني الذي تمثّله نقطة البيانات هذه، بالنانو ثانية منذ تاريخ بدء حساب الفترة.
point[].value[] list قيم كل حقل من حقول نوع البيانات لنقطة البيانات. من المتوقّع أن تحدث كل قيمة تتوافق مع حقل نوع البيانات بالترتيب نفسه الذي تم إدراجه في الحقل في نوع البيانات المحدّد في مصدر البيانات.

لن تتم تعبئة سوى حقل واحد من حقول العدد الصحيح والنقاط العائمة، بناءً على قيمة تعداد التنسيق في حقل نوع مصدر البيانات.

الإجابة

في حال نجاح هذا الإجراء، تعرض هذه الطريقة موردUsers.dataSources.datasets في نص الاستجابة.

تجربة

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