إنّ واجهات برمجة تطبيقات Google Fit، بما في ذلك Google Fit REST API، لن تعود متاحة بعد 30 حزيران (يونيو) 2025. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.

للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة المطلوب نقل البيانات إليها، انتقِل إلى دليل نقل البيانات إلى Health Connect. للمقارنة بين Health Connect وواجهات برمجة تطبيقات Google Fit وواجهات برمجة تطبيقات الويب Fitbit، يُرجى الانتقال إلى دليل المقارنة في Health Connect.

تعرَّف على مزيد من المعلومات حول Health Connect وكيفية الدمج مع واجهة برمجة التطبيقات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Users.dataSources: create

تنشئ مصدر بيانات جديدًا فريدًا على مستوى جميع مصادر البيانات التي تخص هذا المستخدم.

مصدر البيانات هو مصدر فريد لبيانات أداة الاستشعار. يمكن لمصادر البيانات الكشف عن البيانات الأولية الواردة من أدوات استشعار الأجهزة على الأجهزة المحلية أو المرافقة. يمكنها أيضًا الكشف عن البيانات المشتقة، التي تم إنشاؤها عن طريق تحويل أو دمج مصادر بيانات أخرى. يمكن أن توجد مصادر بيانات متعددة لنوع البيانات نفسه. لكل نقطة بيانات في كل مجموعة بيانات يتم إدراجها أو قراءتها من واجهة برمجة تطبيقات اللياقة البدنية مصدر بيانات مرتبط.

ينتج كل مصدر بيانات مصدرًا فريدًا من تعديلات مجموعة البيانات، باستخدام معرّف مصدر بيانات فريد. لا تؤثر كل التغييرات التي تطرأ على مصدر البيانات في معرّف مصدر البيانات، وبالتالي فإنّ البيانات التي يتم جمعها من خلال الإصدارات المُحدَّثة من التطبيق/الجهاز نفسه من الممكن اعتبارها تابعة لمصدر البيانات نفسه.

يتم تحديد مصادر البيانات باستخدام سلسلة ينشئها الخادم، استنادًا إلى محتوى المصدر الذي يتم إنشاؤه. يجب عدم ضبط الحقل dataStreamId عند استدعاء هذه الطريقة. فسيتم إنشاؤه تلقائيًا بواسطة الخادم بالتنسيق الصحيح. وإذا تم ضبط السمة dataStreamId، يجب أن يتطابق هذا التنسيق مع التنسيق الذي سينشئه الخادم. هذا التنسيق عبارة عن مجموعة من بعض الحقول من مصدر البيانات، وله ترتيب محدد. وإذا لم يتطابق، فسيفشل الطلب مع وجود خطأ.

يؤدي تحديد نوع بيانات غير معروف (يبدأ بـ "com.google.") إلى إنشاء مصدر بيانات يحتوي على نوع بيانات مخصّص. لا يمكن قراءة أنواع البيانات المخصّصة إلا من خلال التطبيق الذي أنشأها. تم إيقاف أنواع البيانات المخصّصة، لذا استخدِم أنواع البيانات العادية بدلاً من ذلك.

بالإضافة إلى حقول مصدر البيانات المضمّنة في رقم تعريف مصدر البيانات، يتم تضمين رقم مشروع المطوِّر الذي تمت المصادقة عليه عند إنشاء مصدر البيانات. يتم تشويش رقم مشروع المطوّر هذا عند قراءته من قِبل أي مطوّر آخر يقرأ أنواع البيانات العامة. التجربة الآن

الطلب

طلب HTTP

POST https://www.googleapis.com/fitness/v1/users/userId/dataSources

المعلمات

اسم المعلَمة	القيمة	الوصف
مَعلمات المسار
`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 بالسمات التالية:

اسم الموقع	القيمة	الوصف
الخصائص المطلوبة
`application`	`nested object`	معلومات حول التطبيق الذي يمد بيانات أداة الاستشعار إلى النظام الأساسي.
`application.name`	`string`	اسم هذا التطبيق. هذا الإجراء مطلوب لعملاء REST، ولكننا لا نفرض استخدامًا فريدًا لهذا الاسم. يتم توفير هذه المعلومات تيسيرًا للمطوّرين الآخرين الذين يريدون تحديد REST التي أنشأت تطبيقًا أو مصدر بيانات.
`dataType`	`nested object`	يحدّد نوع البيانات مخططًا لتدفق البيانات التي يتم جمعها من خلال واجهة برمجة تطبيقات اللياقة البدنية أو إدراجها فيها أو الاستعلام عنها.
`dataType.field[]`	`list`	يمثل الحقل بُعدًا واحدًا من نوع البيانات.
`dataType.field[].format`	`string`	التنسيقات المختلفة المتوافقة لكل حقل في نوع البيانات القيم المقبولة هي: "`blob`" "`floatList`" "`floatPoint`" "`integer`" "`integerList`" "`map`" "`string`"
`dataType.field[].name`	`string`	تحدد اسم البيانات وتنسيقها. على عكس أسماء أنواع البيانات، لا تكون أسماء الحقول مع مساحات أسماء، ويجب أن تكون فريدة فقط داخل نوع البيانات.
`dataType.name`	`string`	لكل نوع بيانات اسم فريد يتميز بمساحة اسم. تتم مشاركة جميع أنواع البيانات في مساحة الاسم com.google كجزء من النظام الأساسي.
`device`	`nested object`	تمثّل هذه السمة جهاز مدمج (مثل هاتف أو جهاز قابل للارتداء) يمكنه حمل أجهزة الاستشعار.
`device.manufacturer`	`string`	الشركة المصنّعة للمنتج/الأجهزة
`device.model`	`string`	اسم طراز الجهاز المرئي للمستخدم النهائي
`device.type`	`string`	ثابت يمثّل نوع الجهاز. القيم المقبولة هي: "`chestStrap`" "`headMounted`" "`phone`" "`scale`" "`smartDisplay`" "`tablet`" "`unknown`" "`watch`"
`device.uid`	`string`	الرقم التسلسلي أو معرّف فريد آخر للجهاز يتم تشويش هذا الحقل عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. ولن يظهر الحقل المعرّف الفريد بشكل واضح وعادي إلا لمنشئ مصدر البيانات. يحافظ التشويش على المساواة؛ أي، وفقًا لرقم تعريفي، إذا كان id1 == id2، obfuscated(id1) == obfuscated(id2).
`device.version`	`string`	سلسلة الإصدار لجهاز/برنامج الجهاز
`type`	`string`	رقم ثابت يصف نوع مصدر البيانات هذا. يشير إلى ما إذا كان مصدر البيانات هذا سينتج بيانات أولية أو مشتقة. القيم المقبولة هي: "`derived`" "`raw`"

الإجابة

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

تجربة

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