لكل نقطة بيانات في Google Fit مصدر بيانات مرتبط بها. تحتوي مصادر البيانات على معلومات لتحديد التطبيق أو الجهاز الذي يجمع البيانات أو يحولها.
تتيح لك واجهة برمجة تطبيقات REST تحديد بيانات اللياقة البدنية التي يتم إدراجها في التطبيق. على سبيل المثال، قد يحتاج أحد التطبيقات التي يحلل مجموعة متنوعة من البيانات من سجل اللياقة البدنية للمستخدم إلى تزويد المستخدمين بقائمة بجلسات اللياقة البدنية المضمنة في التحليل، إلى جانب معلومات عن التطبيق الذي تم إدراجه في كل جلسة.
تتيح لك REST API أيضًا ربط البيانات التي تدرجها في مخزن بيانات اللياقة البدنية بتطبيقك.
تحديد التطبيق الذي تم إدراجه من البيانات
للحصول على اسم حزمة تطبيق Android الذي أدرجت جلسة أو اسم تطبيق REST الذي أدرج جلسة:
- استرجع الجلسة.
- اطّلِع على السمة
session.application.packageName
أوsession.application.name
.
للحصول على اسم حزمة تطبيق Android أو اسم تطبيق REST الذي أدرجت مجموعة بيانات:
- استرجع مجموعة البيانات.
- يمكنك استرداد مصدر البيانات من خلال الاطّلاع على
السمة
dataset.dataSourceId
. - اطّلِع على السمة
dataSources.application.packageName
أوdataSources.application.name
.
تحتوي السمة application
على الحقول التالية:
name
- اسم التطبيق:
packageName
- اسم حزمة تطبيق Android
detailsUrl
- (اختياري) معرِّف الموارد المنتظم (URI) للربط بالتطبيق.
عند إدراج جميع الجلسات المتاحة لفاصل زمني في تطبيقك، يمكنك استخدام هذه المعلومات لإطلاع المستخدمين على التطبيق الذي تم إدراجه في كل جلسة.
تقديم معلومات عن طلبك
لإحالة البيانات التي تدرجها في متجر اللياقة البدنية إلى تطبيقك، تأكَّد مما يلي:
- يمكنك إضافة تفاصيل التطبيق إلى السمة
dataSources.application
عند إنشاء مصادر البيانات. - عليك تحديد
datasets.dataSourceId
الصحيح لمصدر بياناتك عند إضافة نقاط إلى مجموعات البيانات.
ويمكن للتطبيقات التي لديها إمكانية الوصول إلى البيانات التي أدرجتها استخدام هذه المعلومات لربط تلك البيانات بتطبيقك.