تُضيف نقاط بيانات إلى مجموعة بيانات. لا حاجة إلى إنشاء مجموعة البيانات في السابق.
سيتم عرض جميع النقاط ضمن مجموعة البيانات المحددة مع المكالمات اللاحقة لاسترداد مجموعة البيانات هذه. يمكن أن تنتمي نقاط البيانات إلى أكثر من مجموعة بيانات واحدة.
لا تستخدِم هذه الطريقة دلالات التصحيح: يتم إدراج نقاط البيانات
المُقدَّمة فقط، بدون استبدال البيانات الحالية.
التجربة الآن
طلب
طلب 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 |
لمزيد من المعلومات، اطلع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، قدِّم الأجزاء ذات الصلة لمورد User.dataSources.datasets، وفقًا لقواعد تصحيح الأخطاء، مع السمات التالية:
| اسم الموقع | القيمة | الوصف | ملاحظات |
|---|---|---|---|
| السمات المطلوبة | |||
dataSourceId |
string |
رقم تعريف مصدر البيانات لمصدر البيانات الذي أنشأ النقاط في مجموعة البيانات هذه. | |
maxEndTimeNs |
long |
أكبر وقت انتهاء لكل نقاط البيانات في هذا التمثيل الجزئي المحتمل لمجموعة البيانات. الوقت نانو ثانية من الحقبة. يجب أن يتطابق هذا أيضًا مع الجزء الثاني من معرّف مجموعة البيانات. | |
minStartTimeNs |
long |
أصغر وقت بدء لجميع نقاط البيانات في هذا التمثيل الجزئي لمجموعة البيانات. الوقت نانو ثانية من الحقبة. ويجب أن يتطابق أيضًا مع الجزء الأول من معرّف مجموعة البيانات. | |
point[] |
list |
قائمة جزئية من نقاط البيانات المضمنة في مجموعة البيانات، مرتبة حسب endTimeNanos. تعتبر هذه القائمة كاملة عند استرداد مجموعة بيانات صغيرة وجزئية عند تصحيح مجموعة بيانات أو استرداد مجموعة بيانات كبيرة جدًا بحيث لا يمكن تضمينها في استجابة واحدة. | |
point[].dataTypeName |
string |
نوع البيانات الذي يُحدِّد تنسيق القيم في نقطة البيانات هذه. | |
point[].endTimeNanos |
long |
تمثّل هذه السمة وقت الانتهاء للفاصلة الذي تمثّله نقطة البيانات هذه، بالمللي ثانية. | |
point[].startTimeNanos |
long |
تمثّل هذه السمة وقت بدء الفاصل الزمني الذي تمثّله نقطة البيانات هذه، بالمللي ثانية. | |
point[].value[] |
list |
قيم كل حقل نوع بيانات لنقطة البيانات من المتوقّع أن تظهر كل قيمة مقابلة لحقل نوع البيانات بالترتيب نفسه الذي تم إدراج الحقل به في نوع البيانات المحدّد في مصدر بيانات. ستتم تعبئة حقل واحد فقط من حقول العدد الصحيح والنقطة العائمة، استنادًا إلى قيمة تعداد التنسيق ضمن حقل النوع "مصدر البيانات". |
|
الإجابة
وإذا نجحت، ستعرض هذه الطريقة مورد User.dataSources.datasets في نص الاستجابة.
جرِّب هذه الميزة الآن.
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة في البيانات المباشرة والاطّلاع على الاستجابة.