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

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

في نص الطلب، قدِّم الأجزاء ذات الصلة من مورد 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 في نص الاستجابة.

جرّب الآن

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