تضيف نقاط البيانات إلى مجموعة البيانات. لا يلزم إنشاء مجموعة البيانات مسبقًا.
سيتم إرجاع جميع النقاط ضمن مجموعة البيانات المحددة مع استدعاءات لاحقة لاسترداد مجموعة البيانات هذه. يمكن أن تنتمي نقاط البيانات إلى أكثر من مجموعة بيانات واحدة.
لا تستخدِم هذه الطريقة دلالات التصحيح: فنقاط البيانات المقدَّمة
يتم إدراجها فقط، بدون استبدال أي بيانات حالية.
التجربة الآن
الطلب
طلب 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 في نص الاستجابة.
تجربة
استخدِم مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.