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

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

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

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

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

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

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

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

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

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

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

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

Android

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

  • لتسجيل البيانات، استخدِم Registering 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