يوفّر Google Fit مجموعة من أنواع بيانات الصحة والعافية ضمن مساحة الاسم com.google
.
تحدد أنواع البيانات تنسيق القيم داخل نقاط البيانات. يمكن أن تمثل نقطة البيانات ما يلي:
- القراءة أو الملاحظة الفورية
- تجميع مع إحصاءات على مدار فترة زمنية
يُعرِّف Google Fit أنواع البيانات للملاحظات الفورية وأنواع البيانات المجمّعة البيانات. تتكون نقاط البيانات من قيم لحقول نوع البيانات ومعلومات الطابع الزمني. تشمل النقاط التي تمثل الملاحظات الفورية الطابع الزمني ونقاط نوع بيانات مجمعة أيضًا وقت البدء للفاصل.
يتيح لك Google Fit أيضًا تحديد أنواع بيانات جديدة.
مجموعات أنواع البيانات
يتضمّن Google Fit أنواع البيانات التالية:
- أنواع البيانات العامة
- تحتوي أنواع البيانات العادية التي يوفّرها النظام الأساسي على "com.google". . على سبيل المثال، com.google.step_count.delta. تلتقط أنواع البيانات هذه قراءات فورية بيانات الصحة والعافية، بما في ذلك نشاط اللياقة البدنية والنوم والتغذية. أي تقييم تطبيقك أن يطلب الأذونات ذات الصلة لقراءة أنواع البيانات هذه والكتابة إليها، باستثناء بعض أنواع بيانات الموقع التي يمكن للتطبيق قراءتها فقط وكتبها.
يمكنك الاطّلاع على ما يلي للحصول على مزيد من المعلومات:
- أنواع البيانات الصحية
- أنواع البيانات التي يوفّرها النظام الأساسي التي تم حظر وصولها بسبب البيانات التي يحتمل أن تكون حساسة. لمزيد من المعلومات، راجع البيانات الصحية الأنواع.
- تجميع أنواع البيانات
- أنواع بيانات لقراءة معلومات الصحة والعافية المجمَّعة حسب الوقت أو ونوع النشاط. لمزيد من المعلومات، يُرجى الاطّلاع على تجميع البيانات. الأنواع.
- أنواع البيانات المخصصة الخاصة
- أنواع البيانات المخصّصة التي يحدّدها تطبيق معيّن. لا يمثل سوى التطبيق الذي يحدد نوع البيانات قراءة وكتابة البيانات من هذا النوع. لمزيد من المعلومات، يُرجى مراجعة أنواع البيانات المخصّصة:
استخدام أنواع البيانات
Android
في نظام Android، يتم تعريف أنواع البيانات كحقول عامة
DataType
الصف. تعتمد كيفية استدعاء واجهات برمجة تطبيقات اللياقة البدنية مع نوع البيانات على ما تريد تحقيقه:
- لتسجيل البيانات، استخدِم Recording API من أجل إنشاء اشتراك لكل نوع بيانات تريد تسجيله
- لقراءة البيانات، استخدِم History API لإرسال قراءة. طلب لكل نوع بيانات.
- لإدراج بيانات سابقة من الماضي، استخدِم History API من أجل: إرسال طلب إدراج لكل نوع بيانات.
- لإنشاء جلسات، استخدِم Sessions API لإدراج الجلسات أو تسجيلها. البيانات مع بيانات تعريف الجلسة.
لإنشاء نقاط بيانات لنظام
DataType
عليك تعيين القيم بالتنسيق الصحيح. يوضح لك المثال التالي
كيفية تعيين صنف الطعام كسلسلة، ونوع الوجبة كقيمة ثابتة من
صف واحد (Field
)
والمحتوى الغذائي كقيم عائمة تم تعيينها.
val nutritionSource = DataSource.Builder() .setDataType(DataType.TYPE_NUTRITION) ... .build() val nutrients = mapOf( Field.NUTRIENT_TOTAL_FAT to 0.4f, Field.NUTRIENT_SODIUM to 1f, Field.NUTRIENT_POTASSIUM to 422f ) val banana = DataPoint.builder(nutritionSource) .setTimestamp(now, TimeUnit.MILLISECONDS) .setField(Field.FIELD_FOOD_ITEM, "banana") .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK) .setField(Field.FIELD_NUTRIENTS, nutrients) .build()
بعد ضبط نقاط البيانات في تطبيقك، يمكنك إدراج نقاط البيانات أو قراءتها أو حذفها. البيانات السابقة باستخدام History API.
راحة
يتضمّن مورد dataSources
نوع البيانات
(وقائمة بحقوله) لكل مصدر بيانات. يمكنك تحديد أحد أنواع البيانات هذه عندما
في إنشاء مصادر البيانات، ويمكنك الحصول على اسم نوع البيانات وقائمة بحقوله
عند استرداد مصدر بيانات من مخزن اللياقة البدنية.
على سبيل المثال، يحدّد تمثيل مصدر البيانات نوع البيانات على النحو التالي:
{ "dataStreamId": "exampleDataSourceId", ... "dataType": { "name": "com.google.step_count.delta" }, ... }
نطاقات الأذونات
تغطي نطاقات التفويض مجموعات من أنواع البيانات التي يمكن للمستخدم إعطاء الإذن لتطبيق بشأنها الوصول إليه. إنها تساعد المستخدمين على فهم أنواع البيانات التي يريد التطبيق الوصول إليها. وتسهّل أيضًا منح التطبيقات الإذن باستخدام هذه البيانات من خلال عدم للموافقة على كل نوع من أنواع البيانات الفردية. يمنح المستخدمون هذه الأذونات بعد نزَّلوا تطبيقك.
![مثال على شاشة الموافقة على نطاقات OAuth](https://developers-dot-devsite-v2-prod.appspot.com/static/fit/images/OAuth_scopes_example.png?authuser=4&hl=ar)
بعد اختبار تطبيقك مع عدد صغير من المستخدمين، قبل إطلاق تحتاج إلى طلب التحقق استنادًا إلى النطاقات ذات الصلة بأنواع البيانات هذه. قراءة صفحات أنواع البيانات المرتبطة أعلاه لفهم النطاقات التي تنطبق على كل نوع بيانات.
على سبيل المثال، إذا كان تطبيقك يحتاج إلى قراءة وكتابة ضغط الدم، إلى أن يعلن أنه يقوم بالقراءة والكتابة ويطلب كلا النطاقين. إذا كان فقط كتابة بيانات ضغط الدم إلى نظام Google Fit، تحتاج فقط إلى لطلب نطاق الكتابة.
اختَر أنواع البيانات بمسؤولية. عدم طلب كل نوع بيانات في حال كان تطبيقك قد يحتاج إليها. تُحدِّد الأنواع المحدّدة النطاقات التي يُطلب من المستخدم استخدامها. أن تمنح الإذن لها. لا تطلب سوى أنواع البيانات التي يحتاجها تطبيقك ليتمكّن المستخدمون من من المرجح أن تمنح حق الوصول. المستخدمون الذين يمكنهم بسهولة منح إذن الوصول إلى محتوى محدود وواضح النطاقات الموضحة.
استخدِم هذا الجدول للتحقّق ممّا إذا كانت النطاقات التي يحتاج تطبيقك إلى الوصول إليها حسّاسة أو مقيَّدة (التي تحدد عملية إثبات ملكية الخطوات التي عليك اتّباعها):
النطاق | الوصف | الفئة |
---|---|---|
https://www.googleapis.com/auth/fitness.activity.read |
قراءة بيانات النشاط من منصة Google Fit | محظور |
https://www.googleapis.com/auth/fitness.activity.write |
كتابة بيانات النشاط في نظام Google Fit الأساسي | محظور |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
قراءة بيانات نسبة الغلوكوز في الدم من منصة Google Fit | محظور |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
كتابة بيانات نسبة الغلوكوز في الدم على منصة Google Fit | محظور |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
قراءة بيانات ضغط الدم من منصة Google Fit | محظور |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
كتابة بيانات ضغط الدم على منصة Google Fit. | محظور |
https://www.googleapis.com/auth/fitness.body.read |
قراءة بيانات قياس الجسم (الطول والوزن ونسبة الدهون في الجسم) من منصة Google Fit. | محظور |
https://www.googleapis.com/auth/fitness.body.write |
كتابة بيانات قياس الجسم على منصة Google Fit. | محظور |
https://www.googleapis.com/auth/fitness.body_temperature.read |
قراءة بيانات درجة حرارة الجسم من منصة Google Fit | محظور |
https://www.googleapis.com/auth/fitness.body_temperature.write |
كتابة بيانات درجة حرارة الجسم على منصة Google Fit | محظور |
https://www.googleapis.com/auth/fitness.heart_rate.read |
قراءة بيانات معدّل نبضات القلب من منصة Google Fit. | محظور |
https://www.googleapis.com/auth/fitness.heart_rate.write |
كتابة بيانات معدّل نبضات القلب على منصة Google Fit. | محظور |
https://www.googleapis.com/auth/fitness.location.read |
قراءة بيانات الموقع الجغرافي من منصة Google Fit | محظور |
https://www.googleapis.com/auth/fitness.location.write |
كتابة بيانات الموقع الجغرافي على نظام Google Fit الأساسي | محظور |
https://www.googleapis.com/auth/fitness.nutrition.read |
يمكنك الاطّلاع على بيانات التغذية من منصة Google Fit. | محظور |
https://www.googleapis.com/auth/fitness.nutrition.write |
كتابة بيانات التغذية في نظام Google Fit. | محظور |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
قراءة بيانات نسبة تشبّع الأكسجين في الدم من منصة Google Fit | محظور |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
كتابة بيانات تشبع الأكسجين في نظام Google Fit الأساسي | محظور |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
يمكنك الاطّلاع على بيانات الصحة الإنجابية من منصة Google Fit. | محظور |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
كتابة بيانات الصحة الإنجابية على منصة Google Fit | محظور |
https://www.googleapis.com/auth/fitness.sleep.read |
قراءة بيانات النوم من نظام Google Fit الأساسي | محظور |
https://www.googleapis.com/auth/fitness.sleep.write |
كتابة بيانات النوم على نظام Google Fit الأساسي | محظور |
إضافة نطاقات جديدة إلى تطبيق حالي
عند تحديث تطبيقك لطلب نطاق جديد (على سبيل المثال، إذا أضفت النطاق الجديد نطاق النوم أو معدل ضربات القلب أو إضافة نطاق القراءة)، سيُطلب من المستخدمين يطلب تطبيقك إذن الوصول إلى هذه النطاقات، ويمكنه اختيار منح أو رفض طلب إذن الوصول
من أفضل الممارسات طلب تفويض من المستخدمين للموارد في ذلك الوقت تحتاج إليها. اتبع الإرشادات حول طلب تزايد التفويض.
سيزيد احتمال منح المستخدمين إذن الوصول في حال فهم سبب/كيفية استخدام تطبيقك. هذه البيانات:
- ننصحك بإضافة شاشة تحذّر المستخدمين أو تُعلمهم بأنّه سيُطلب منهم هذه النطاقات.
- اشرح بوضوح سبب طلب التطبيق للوصول إلى هذه النطاقات/البيانات حتى المستخدمين اتخاذ قرار مستنير.
مزيد من المعلومات حول أفضل الممارسات المتعلّقة بأذونات التطبيق لنظام التشغيل Android