أنواع البيانات

يوفّر Google Fit مجموعة من أنواع بيانات الصحة والعافية ضمن مساحة الاسم com.google.

تحدّد أنواع البيانات تنسيق القيم داخل نقاط البيانات. يمكن أن تمثّل نقطة البيانات ما يلي:

  • قراءة أو ملاحظة فورية
  • تجميع يحتوي على إحصاءات خلال فترة زمنية

يحدد تطبيق Google Fit أنواع البيانات للملاحظات الفورية وأنواع البيانات المجمّعة. تتألف نقاط البيانات من قيم لحقول نوع البيانات ومعلومات الطابع الزمني. تتضمّن النقاط التي تمثّل الملاحظات الفورية طابعًا زمنيًا، وتشمل أيضًا النقاط من نوع بيانات مجمّعة وقت البدء للفاصل الزمني.

كما يتيح لك Google Fit تحديد أنواع البيانات الجديدة.

مجموعات أنواع البيانات

يحتوي تطبيق Google Fit على أنواع البيانات التالية:

أنواع البيانات المتاحة للجميع
تحتوي أنواع البيانات العادية التي يوفّرها النظام الأساسي على البادئة "com.google". على سبيل المثال، com.google.step_count.delta. تلتقط أنواع البيانات هذه قراءات فورية لبيانات الصحة والعافية، بما في ذلك أنشطة اللياقة البدنية والنوم والتغذية. يمكن لأي تطبيق طلب الأذونات ذات الصلة بقراءة أنواع البيانات هذه والكتابة فيها، باستثناء بعض أنواع بيانات الموقع التي لا يمكن قراءتها إلا من خلال التطبيق الذي كتبها.

يمكنك الاطّلاع على ما يلي للحصول على مزيد من المعلومات:

أنواع البيانات المتعلقة بالصحة
أنواع البيانات التي يوفّرها النظام الأساسي والتي يحظّر الوصول إليها بسبب احتمال وجود بيانات حسّاسة. لمزيد من المعلومات، راجِع أنواع بيانات الصحة.
أنواع البيانات المجمّعة
أنواع البيانات لقراءة معلومات الصحة والعافية مجمّعة حسب الوقت أو نوع النشاط. ولمزيد من المعلومات، يُرجى الاطّلاع على مقالة أنواع بيانات البيانات المجمَّعة.
أنواع البيانات المخصصة الخاصة
أنواع البيانات المخصّصة التي يحدّدها تطبيق معيّن هي فقط التطبيقات التي تحدّد نوع البيانات، ويمكنها قراءة البيانات من هذا النوع وكتابتها. ولمزيد من المعلومات، يُرجى الاطّلاع على أنواع البيانات المخصّصة.

استخدام أنواع البيانات

Android

على نظام التشغيل Android، يتم تحديد أنواع البيانات على أنها حقول عامة للصف DataType. تعتمد كيفية استدعاء واجهات برمجة تطبيقات اللياقة البدنية بنوع البيانات على ما تريد تحقيقه:

لإنشاء نقاط بيانات لعنصر غير متوافق 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()

بعد إعداد نقاط البيانات في تطبيقك، يمكنك إدراج البيانات القديمة أو قراءتها أو حذفها باستخدام واجهة برمجة تطبيقات السجل.

الراحة

ويتضمّن مورد dataSources نوع البيانات (وقائمة بحقوله) لكل مصدر بيانات. يمكنك تحديد أحد أنواع البيانات هذه عند إنشاء مصادر البيانات، ويمكنك الحصول على اسم نوع البيانات وقائمة بحقوله عند استرداد مصدر البيانات من متجر اللياقة البدنية.

على سبيل المثال، يحدد تمثيل مصدر البيانات نوع البيانات كما يلي:

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

نطاقات التفويض

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

مثال على شاشة الموافقة على نطاقات OAuth
الشكل 2.شاشة الموافقة على نطاقات OAuth.

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

على سبيل المثال، إذا احتاج تطبيقك إلى قراءة ضغط الدم وكتابته، يجب أن يعلن التطبيق أنه بصدد كلا القراءة والكتابة وطلب النطاقين معًا. إذا كان الجهاز يكتب بيانات ضغط الدم فقط في النظام الأساسي لـ 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.