تمام نقاط پایانی API گوگل هلث که دادههای کاربر را میخوانند و مینویسند، برای جمعآوری دادهها از طریق یک یا چند محدوده، به رضایت کاربر نیاز دارند. برنامه باید هنگام فراخوانی نقطه پایانی احراز هویت OAuth2 گوگل، فهرست محدودهها را ارائه دهد. به بخش «دریافت توکنهای دسترسی OAuth2» مراجعه کنید. توکن دسترسی صادر شده فقط شامل محدودههایی خواهد بود که کاربر رضایتدهنده مجاز کرده است.
تمام محدودههای API گوگل هلث با موارد زیر شروع میشوند:
https://www.googleapis.com/auth/googlehealth
پیادهسازی
برای ارائه بهترین تجربه کاربری و تضمین رعایت امنیت، هنگام درخواست scopeها باید:
- فقط محدودههای مورد نیاز را درخواست کنید : فقط دسترسی به محدودههای داده خاصی را که برنامه شما برای عملکرد خود به آنها نیاز دارد، درخواست کنید.
- پیکربندی دسترسی فقط نوشتن هنگام ارسال داده : فقط در صورتی که دادهها را به Google Health ارسال میکنید، دسترسی «نوشتن» (مثلاً با استفاده از یک محدوده
writeonly) را پیکربندی کنید. - رضایت جزئی را به درستی مدیریت کنید : اگر کاربر تمام حوزههای نمایش داده شده در صفحه رضایت را انتخاب نکند، برنامه شما نباید با شکست مواجه شود.
- اگر برنامه شما برای عملکرد به همه حوزههای ارائه شده نیاز دارد، میتوانید متن زیر را ارائه دهید: «برای بهترین تجربه کاربری، توصیه میکنیم همه حوزهها را فعال کنید.»
محدودههای موجود
| محدوده | اجازه |
|---|---|
| .فعالیت_و_تناسب_اندام.فقط_خواندنی | اطلاعات فعالیت و تناسب اندام Google Health خود را ببینید. |
| .activity_and_fitness.فقط نوشتنی | دادههای فعالیت و تناسب اندام را به Google Health اضافه کنید و دادههایی را که اضافه میکند ویرایش یا حذف کنید. |
| .ecg.فقط خواندنی | دادههای نوار قلب گوگل هلث خود را ببینید. |
| .معیارها_و_اندازهگیریهای_سلامت.فقط_خواندنی | معیارهای سلامت و دادههای اندازهگیری Google Health خود را ببینید. |
| .معیارها_و_اندازهگیریهای_سلامت.فقط_نوشتنی | دادههای معیارها و سنجشهای سلامت را به Google Health اضافه کنید و دادههایی را که اضافه میکند ویرایش یا حذف کنید. |
| .irn.فقط خواندنی | دادههای اعلانهای ریتم نامنظم قلب گوگل هلث خود را مشاهده کنید. |
| .مکان.فقط خواندنی | موقعیت مکانی GPS ثبت شده خود در Google Health را در حین ورزش مشاهده کنید. |
| علائم_ثبتشده.فقط_نوشتنی | دادههای علائم ثبتشده را به Google Health اضافه کنید و دادههایی را که اضافه میکند ویرایش یا حذف کنید. |
| .ذهن آگاهی.فقط بنویس | دادههای ذهنآگاهی را به Google Health اضافه کنید و دادههایی را که اضافه میکند ویرایش یا حذف کنید. |
| .تغذیه.فقط خواندنی | دادههای تغذیهای Google Health خود را ببینید. |
| .تغذیه.فقط بنویس | دادههای تغذیهای را به Google Health اضافه کنید و دادههایی را که اضافه میکند ویرایش یا حذف کنید. |
| .profile.فقط خواندنی | اطلاعات پروفایل گوگل هلث خود را ببینید. |
| .profile.فقط نوشتنی | دادههای نمایه را به Google Health اضافه کنید و دادههایی را که اضافه میکند ویرایش یا حذف کنید. |
| .سلامت_باروری.فقط_نوشتنی | دادههای سلامت باروری را به Google Health اضافه کنید و دادههایی را که اضافه میکند ویرایش یا حذف کنید. |
| تنظیمات.فقط خواندنی | تنظیمات Google Health خود را ببینید. |
| تنظیمات.فقط نوشتنی | دادههای تنظیمات را به Google Health اضافه کنید و دادههایی را که اضافه میکند ویرایش یا حذف کنید. |
| .sleep.only (فقط خواندنی) | دادههای خواب Google Health خود را ببینید. |
| .sleep.only | دادههای خواب را به Google Health اضافه کنید و دادههایی را که اضافه میکند ویرایش یا حذف کنید. |