تتطلّب جميع نقاط نهاية Google Health API التي تقرأ بيانات المستخدم وتكتبها موافقة المستخدم على جمع هذه البيانات من خلال نطاق واحد أو أكثر. يجب أن يقدّم التطبيق قائمة النطاقات عند استدعاء نقطة نهاية مصادقة OAuth2 من Google. الاطّلاع على مقالة الحصول على رموز OAuth2 المميزة للوصول. لن يحتوي رمز الوصول الذي يتم إصداره إلا على النطاقات التي أذن بها المستخدم الذي قدّم موافقته.
تبدأ جميع نطاقات Google Health API بما يلي:
https://www.googleapis.com/auth/googlehealth
التنفيذ
لتقديم أفضل تجربة للمستخدم وضمان الامتثال للمتطلبات الأمنية، يجب اتّباع ما يلي عند طلب النطاقات:
- طلب النطاقات اللازمة فقط: يجب طلب الوصول إلى نطاقات البيانات المحدّدة التي يحتاجها تطبيقك لكي يعمل فقط.
- ضبط إذن الكتابة فقط عند إرسال البيانات: يجب ضبط إذن "الكتابة"
فقط (على سبيل المثال، باستخدام نطاق
writeonly) إذا كنت ترسل بيانات إلى Google Health. - التعامل مع الموافقة الجزئية بشكل سليم: يجب ألا يتعطّل تطبيقك
إذا لم يحدّد المستخدم جميع النطاقات المعروضة على شاشة طلب الموافقة.
- إذا كان تطبيقك يتطلّب جميع النطاقات المعروضة لكي يعمل، يمكنك عرض النص التالي: "لتقديم أفضل تجربة للمستخدم، ننصحك بتفعيل جميع النطاقات."
النطاقات المتاحة
| النطاق | الإذن |
|---|---|
| .activity_and_fitness.readonly | الاطّلاع على بيانات النشاط واللياقة البدنية في Google Health |
| .activity_and_fitness.writeonly | إضافة بيانات النشاط واللياقة البدنية إلى Google Health وتعديل أو حذف البيانات التي يضيفها |
| .ecg.readonly | الاطّلاع على بيانات مخطَّط كهربية القلب (ECG) في Google Health |
| .health_metrics_and_measurements.readonly | الاطّلاع على بيانات المقاييس والقياسات الصحية في Google Health |
| .health_metrics_and_measurements.writeonly | إضافة بيانات المقاييس والقياسات الصحية إلى Google Health وتعديل أو حذف البيانات التي يضيفها |
| .irn.readonly | الاطّلاع على بيانات "إشعارات اضطراب نظم القلب على Google Health" |
| .location.readonly | الاطّلاع على الموقع الجغرافي الذي سجّله جهاز GPS في Google Health أثناء ممارسة التمارين |
| .nutrition.readonly | الاطّلاع على بيانات التغذية في Google Health |
| .nutrition.writeonly | إضافة بيانات التغذية إلى Google Health وتعديل أو حذف البيانات التي يضيفها |
| .profile.readonly | الاطّلاع على بيانات الملف الشخصي في Google Health |
| .profile.writeonly | إضافة بيانات الملف الشخصي إلى Google Health وتعديل أو حذف البيانات التي يضيفها |
| .settings.readonly | الاطّلاع على إعدادات Google Health |
| .settings.writeonly | إضافة بيانات الإعدادات إلى Google Health وتعديل أو حذف البيانات التي يضيفها |
| .sleep.readonly | الاطّلاع على بيانات النوم في Google Health |
| .sleep.writeonly | إضافة بيانات النوم إلى Google Health وتعديل أو حذف البيانات التي يضيفها |