یادداشت‌های انتشار

‫۱۴ اکتبر ۲۰۲۶

فیلتر کردن خانواده منبع داده

فیلتر کردن خانواده منبع داده با قابلیت‌های زیر به‌روز شد:

  • پشتیبانی از پارامتر dataSourceFamily به نقطه پایانی users.dataTypes.dataPoints list برای همه انواع داده به‌جز sleep، food، و food-measurement-unit اضافه شد.
  • خانواده منبع داده users/me/dataSourceFamilies/self-sources به نقاط پایانی list،‏ reconcile،‏ rollUp، و dailyRollUp اضافه شد تا مشتریان بتوانند نقاط داده‌ای را که خودشان نوشته‌اند پُرسمان کنند، ازجمله وقتی‌که فقط .writeonly scopes به آن‌ها اعطا شده است.

به‌روزرسانی‌های برجسته اسناد

  • راهنمای فیلتر کردن داده‌ها با جزئیات و نمونه‌هایی برای استفاده از dataSourceFamily در نقطه پایانی list، پُرسمان self-sources با دامنه‌های فقط نوشتنی، و مدیریت محدودیت‌های نوع داده به‌روز شد.

‫۱ اکتبر ۲۰۲۶

کانال بتای جدید

کانال v4beta اضافه شد تا به‌عنوان پیش‌نمایش عمومی برای آزمایش گسترده شریک و اعتبارسنجی بازار قبل‌از ارتقا به کانال پایدار v4 عمل کند. عناصر میانای برنامه‌سازی کاربردی که فقط در v4beta دردسترس هستند، با v4beta در اسناد برچسب‌گذاری خواهند شد.

برای اطلاعات بیشتر، اسناد مرجع را ببینید.

نوع داده جدید

پشتیبانی از نوع داده زیر اضافه شد:

  • سنجه‌ها و اندازه‌گیری‌های سلامتی: skin-temperature-sensors v4beta

راهنمای میانای برنامه‌سازی کاربردی جدید

راهنمای جدیدی برای دمای پوست اضافه شد که جزئیات نحوه استفاده از انواع داده‌های مربوط به دمای پوست را ارائه می‌دهد.

‫۱۷ اوت ۲۰۲۶

دوربین تفنگ جدید

گستره‌های فقط نوشتنی زیر اضافه شد:

  • ‫.logged_symptoms.writeonly برای ثبت علائم فیزیکی.
  • .mindfulness.writeonly برای ثبت حالت‌های احساسی و خلق‌وخو.
  • .reproductive_health.writeonly برای ثبت دوره‌های قاعدگی و نتایج آزمایش تخمک‌گذاری.

انواع داده‌های جدید

پشتیبانی از انواع داده زیر اضافه شد:

  • سلامت زنان: menstrual-period، moods، ovulation-test، symptoms

به‌روزرسانی‌های برجسته اسناد

  • راهنمای سلامت زنان اضافه شد تا به شما کمک کند داده‌های بهداشت باروری و سلامت زنان را در برنامه‌هایتان ادغام کنید.

‫۱۴ اوت ۲۰۲۶

راهنمای انتقال به‌روزشده

نمای کلی انتقال را با راهنمایی‌های جامع‌تر به‌روز کرده‌ایم و برخی‌از محتواهای قدیمی را برداشته‌ایم.

صفحه جدید «تبلیغ Google Health»

صفحه جدید تبلیغ Google Health روش‌های توصیه‌شده برای نمایش Google Health در برنامه‌تان و نحوه تشویق کاربران به اتصال را پوشش می‌دهد. همچنین مکان جدیدی برای رهنمودهای نمانام Google Health است.

‫۲۲ ژوئن ۲۰۲۶

داشبورد وضعیت Google Health

داشبورد وضعیت Google Health اضافه شد تا اطلاعات وضعیت سرویس‌هایی را که بخشی از Google Health هستند ارائه دهد.

‫۱۷ ژوئن ۲۰۲۶

ابزار برابری Google Health API

ابزار برابری Google Health API با دامنه‌های اضافی به‌روز شد: active-energy-burned، electrocardiogram، core-body-temperature، blood-glucose، irregular-rhythm-notification، food، food-measurement-unit، nutrition-log، و exportExerciseTcx.

‫۲۶ مه ۲۰۲۶

دوربین تفنگ جدید

  • .ecg.readonly برای خواندن داده‌های نوار قلب.
  • .irn.readonly برای خواندن داده‌های IRN.

تغییرات نام دامنه

جایگزین کردن گستره‌های خواندن/نوشتن با .writeonly. توسعه‌دهندگان اکنون باید اجازه‌های خواندن و نوشتن را به‌طور صریح مشخص کنند.

  • .activity_and_fitness اکنون .activity_and_fitness.writeonly است
  • .health_metrics_and_measurements اکنون .health_metrics_and_measurements.writeonly است
  • .nutrition اکنون .nutrition.writeonly است
  • .profile اکنون .profile.writeonly است
  • .settings اکنون .settings.writeonly است
  • .sleep اکنون .sleep.writeonly است

انواع داده‌های جدید

پشتیبانی از انواع داده زیر اضافه شد:

  • فعالیت و تناسب اندام: active-energy-burned
  • ECG: electrocardiogram
  • سنجه‌ها و اندازه‌گیری‌های سلامتی: core-body-temperature، blood-glucose
  • IRN: irregular-rhythm-notification
  • تغذیه: food، food-measurement-unit، nutrition-log

نقطه‌های پایانی جدید

  • project.subscribers.subscriptions: روش‌های create، delete، list، و patch برای مدیریت دستی اشتراک.
  • users: getIrnProfile تعامل فعلی کاربر با ویژگی IRN را برمی‌گرداند
  • users.pairedDevices: get و list دستگاه‌های جفت‌شده با حساب کاربر.

وب‌قلاب‌ها

پشتیبانی از عملکرد وب‌قلاب زیر اضافه شد:

  • پشتیبانی اشتراک دستی وقتی مشترک ثبت می‌شود.
  • پشتیبانی از اعلان برای انواع داده activityLevel، bloodGlucose، dailyRespiratoryRate، heartRateVariability، height، hydrationLog، nutritionLog، respiratoryRateSleepSummary، runVo2Max، sedentaryPeriod، timeInHeartRateZone.
  • پشتیبانی از سنجه‌های سفارشی، هشدارها، و خطاهای مشترک در «کنسول Google Cloud».
  • اگر ارتباط با مشترک قطع شود، اعلان‌های وب‌قلاب ناموفق را به‌طور خودکار تا ۷ روز دوباره امتحان می‌کند.

به‌روزرسانی‌های برجسته اسناد

‫۱۴ آوریل ۲۰۲۶

انواع داده‌های جدید

  • فعالیت و تناسب اندام: swim-lengths-data
  • سنجه‌ها و اندازه‌گیری‌های سلامتی: height

نقطه‌های پایانی جدید

  • project.subscribers: روش‌های delete، get، list، و patch برای مدیریت دستی اشتراک.
  • users.dataTypes.dataPoints: get یک نقطه داده تکی را براساس شناسه برمی‌گرداند.

پشتیبانی وب‌قلاب

  • ایجاد خودکار اشتراک هنگام ثبت‌نام مشترک.
  • اشتراک‌هایتان را به‌طور دستی بااستفاده از نقاط پایانی project.subscribers مدیریت کنید
  • پشتیبانی از اعلان برای انواع داده activeZoneMinutes، altitude، bodyFat، caloriesInHeartRateZone، dailyHeartRateVariability، dailyHeartRateZones، dailyOxygenSaturation، dailyRestingHeartRate، dailySleepTemperatureDerivations، distance، exercise، floors، heartRate، sleep، steps، totalCalories، و weight.

ویژگی‌های اضافی

  • کتابخانه‌های REST در Github: کتابخانه‌های Google Health API REST برای همه کتابخانه‌های کارخواه پشتیبانی‌شده موجود در پروژه Github Google APIs دردسترس است.
  • پشتیبانی از API Explorer: نقاط پایانی را می‌توان بااستفاده از API Explorer که در اسناد مرجع تعبیه شده است فراخوانی کرد.
  • پشتیبانی از OAuth Playground: Google Health API v4 در OAuth 2.0 Playground فهرست شده است، ابزاری که به شما امکان می‌دهد نقاط پایانی را که از کتابخانه OAuth Google پشتیبانی می‌کنند فراخوانی کنید.

‫۲۴ مارس ۲۰۲۶

اعلامیه راه‌اندازی Google Health API

Google Health API نسل بعدی Fitbit Web API است که از پایه ساخته شده و برای انجمن توسعه‌دهندگان ارزشمند ما طراحی شده است. این نسخه اولیه بر دستیابی به برابری با Fitbit Web API در پردرخواست‌ترین انواع داده‌ها، همراه با افزودن عملکردی که انجمن توسعه‌دهندگان درخواست کرده است، تمرکز دارد. در اینجا نگاهی به ویژگی‌های دردسترس امروز می‌اندازیم.

نکات برجسته ویژگی‌های اصلی

  • راه‌اندازی ساده: پروژه‌هایتان را ثبت کنید و شناسه‌های کارخواه OAuth را مستقیماً ازطریق «کنسول Google Cloud» آشنا مدیریت کنید.
  • پشتیبانی گسترده از پلاتفرم: برای ادغام بی‌وقفه در همه زبان‌ها و پلاتفرم‌های برنامه‌نویسی اصلی، از کتابخانه‌های Google OAuth2 استفاده کنید.
  • دسترسی ساده‌شده به داده‌ها: از تعاریف جدید گستره استفاده کنید که چند نوع داده را در یک گستره واحد و با مدیریت آسان ادغام می‌کند.
  • نقاط پایانی یکسان در انواع داده: با نقاط پایانی جدید و یکسان و پشتیبانی از فیلتر که برای ساده‌سازی عملکرد در همه انواع داده طراحی شده است، تجربه کدنویسی ساده‌تری داشته باشید.
  • پوشش جامع داده‌ها: دسترسی به پشتیبانی خواندن و نوشتن در چندین نوع داده.
  • اعلان‌های هم‌زمان: با پشتیبانی بهبودیافته Webhook، به‌روزرسانی‌ها را فوراً دریافت کنید. این ویژگی شامل ایجاد خودکار اشتراک و محتوای غنی‌تر پیام اعلان است.
  • پشتیبانی پیش‌فرض از داده‌های درون‌روزی: بااستفاده از نقطه پایانی فهرست، داده‌های درون‌روزی تفصیلی را به‌طور پیش‌فرض بازیابی کنید و مراحل اضافی را حذف کنید.
  • مجموعه کامل اسناد: با اسناد جامع جدید ما، ازجمله موارد زیر، به‌سرعت راه‌اندازی کنید و شروع به کار کنید:
    • راهنماهای شروع به کار، میانای برنامه‌سازی کاربردی، انتقال، و عیب‌یابی
    • راهنمای مرجع کامل برای REST
    • ابزار جدید Google Health API Parity، کد نمونه، و codelab راهنمایی‌شده

انواع داده‌های پشتیبانی‌شده

این راه‌اندازی دسترسی به انواع داده‌های ضروری را فراهم می‌کند و اطمینان می‌دهد که اطلاعات اصلی موردنیاز برای ساخت راه‌حل‌های نوآورانه سلامت را دراختیار دارید.

انواع داده‌ای که از خواندن پشتیبانی می‌کنند:

  • فعالیت و تناسب اندام: دقایق فعال، دقایق محدوده فعال، سطح فعالیت، ارتفاع، کالری در محدوده‌های ضربان قلب، حداکثر اکسیژن مصرفی روزانه، مسافت، تمرین، طبقات، حداکثر اکسیژن مصرفی در دویدن، دوره بی‌تحرکی، تعداد قدم‌ها، زمان در محدوده ضربان قلب، مجموع کالری، حداکثر اکسیژن مصرفی
  • سنجه‌ها و اندازه‌گیری‌های سلامتی: چربی بدن، تغییرپذیری ضربان قلب روزانه، محدوده‌های ضربان قلب روزانه، اشباع اکسیژن روزانه، سرعت تنفس روزانه، ضربان قلب حین استراحت روزانه، مشتقات دمای خواب روزانه، ضربان قلب، تغییرپذیری ضربان قلب، اشباع اکسیژن، سرعت تنفس، خلاصه اطلاعات خواب، وزن
  • هویت: شناسه کاربر Fitbit و شناسه کاربر Google را برمی‌گرداند
  • مکان: داده‌های GPS براساس تمرین ثبت‌شده که در قالب TCX نشان داده می‌شود
  • تغذیه: گزارش آب‌رسانی
  • نمایه: اطلاعات نمایه اصلی کاربران
  • تنظیمات: تنظیمات برنامه تلفن همراه و دستگاه پیکربندی‌شده کاربران
  • خواب: گزارش‌های خواب «کلاسیک» و «مراحل»

انواع داده‌ای که از نوشتن پشتیبانی می‌کنند:

می‌توانید داده‌های این نوع داده‌ها را بنویسید و اصلاح کنید:

  • فعالیت و تناسب اندام: تمرین
  • سنجه‌ها و اندازه‌گیری‌های سلامتی: چربی بدن، وزن
  • نمایه
  • تنظیمات
  • خواب

نقطه‌های پایانی کلیدی برای تعامل

نقطه‌های پایانی زیر برای مدیریت اشتراک‌ها، کاربران، و داده‌های سلامت و تناسب اندام دردسترس است:

  • users: getIdentity، getProfile، getSettings، updateProfile، و updateSettings روش برای مدیریت هویت و نمایه.
  • users.dataTypes.dataPoints: روش‌های batchDelete،‏ dailyRollUp،‏ list،‏ patch،‏ reconcile، و rollUp برای مدیریت جامع نوع داده.