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

يوفّر 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
الشكل 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