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

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

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

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

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

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

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

يتضمّن Google Fit أنواع البيانات التالية:

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

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

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

• أنواع بيانات النشاط
• أنواع بيانات الموقع الجغرافي
• أنواع بيانات التغذية

أنواع البيانات الصحية

أنواع البيانات التي يوفّرها النظام الأساسي التي تم حظر وصولها بسبب البيانات التي يحتمل أن تكون حساسة. لمزيد من المعلومات، راجع البيانات الصحية الأنواع.

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

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

أنواع البيانات المخصصة الخاصة

أنواع البيانات المخصّصة التي يحدّدها تطبيق معيّن. لا يمثل سوى التطبيق الذي يحدد نوع البيانات قراءة وكتابة البيانات من هذا النوع. لمزيد من المعلومات، يُرجى مراجعة أنواع البيانات المخصّصة:

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

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()

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

نطاقات الأذونات

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

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

على سبيل المثال، إذا كان تطبيقك يحتاج إلى قراءة وكتابة ضغط الدم، إلى أن يعلن أنه يقوم بالقراءة والكتابة ويطلب كلا النطاقين. إذا كان فقط كتابة بيانات ضغط الدم إلى نظام Google Fit، تحتاج فقط إلى لطلب نطاق الكتابة.

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

استخدِم هذا الجدول للتحقّق ممّا إذا كانت النطاقات التي يحتاج تطبيقك إلى الوصول إليها حسّاسة أو مقيَّدة (التي تحدد عملية إثبات ملكية الخطوات التي عليك اتّباعها):

إضافة نطاقات جديدة إلى تطبيق حالي

عند تحديث تطبيقك لطلب نطاق جديد (على سبيل المثال، إذا أضفت النطاق الجديد نطاق النوم أو معدل ضربات القلب أو إضافة نطاق القراءة)، سيُطلب من المستخدمين يطلب تطبيقك إذن الوصول إلى هذه النطاقات، ويمكنه اختيار منح أو رفض طلب إذن الوصول

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

سيزيد احتمال منح المستخدمين إذن الوصول في حال فهم سبب/كيفية استخدام تطبيقك. هذه البيانات:

• ننصحك بإضافة شاشة تحذّر المستخدمين أو تُعلمهم بأنّه سيُطلب منهم هذه النطاقات.
• اشرح بوضوح سبب طلب التطبيق للوصول إلى هذه النطاقات/البيانات حتى المستخدمين اتخاذ قرار مستنير.

مزيد من المعلومات حول أفضل الممارسات المتعلّقة بأذونات التطبيق لنظام التشغيل Android