شروع به کار

به Google Health API خوش آمدید!

این API جدید از Google OAuth استفاده می‌کند و راهکاری امن‌تر، کاربرپسندتر، و مقیاس‌پذیر برای دسترسی و مدیریت داده‌های سلامتی ارائه می‌دهد. در اینجا برخی‌از مزایا آورده شده است:

  • امنیت بهبودیافته: این API جدید با توصیه‌های امنیتی فعلی Google و روال‌های مطلوب برای طراحی و پیاده‌سازی API هماهنگ است و خطر آسیب‌پذیری‌ها را کاهش می‌دهد.

  • ثبات: این API جدید از اصول طراحی مدرن API پیروی می‌کند و تجربه توسعه‌دهنده سازگارتر و شهودی‌تری ارائه می‌دهد.

  • مقاوم‌سازی دربرابر آینده

    • مقیاس‌پذیری: این API جدید به‌گونه‌ای طراحی شده است که با نیازهای آینده سازگار باشد و از تعداد رو به رشد کاربران و انواع داده‌ها پشتیبانی کند.
    • قابلیت نگهداری: اتخاذ یک رویکرد استاندارد باعث می‌شود نگهداری و به‌روزرسانی برنامه‌ها آسان‌تر شود و بدهی فنی کاهش یابد.
    • دسترسی به ویژگی‌های جدید: انتقال به API جدید دسترسی به ویژگی‌ها و عملکردهای جدید را به‌محض انتشار آن‌ها فراهم می‌کند و تضمین می‌کند که برنامه‌ها به‌روز بمانند و از جدیدترین پیشرفت‌ها بهره‌مند شوند.
    • رعایت استانداردها: این «میانای برنامه‌سازی کاربردی» جدید با جدیدترین استانداردهای امنیتی و حریم خصوصی Google به‌روز نگه داشته می‌شود و تلاش لازم برای رعایت استانداردها در برنامه‌ها را کاهش می‌دهد.
    • حریم خصوصی داده‌ها: سیستم Google OAuth به‌گونه‌ای طراحی شده است که با مقررات مختلف حریم خصوصی داده‌ها (برای نمونه، «مقررات عمومی حفاظت از داده‌ها» و HIPAA) مطابقت داشته باشد و بار رعایت این مقررات را برای توسعه‌دهندگان کاهش دهد.

چگونه شروع کنیم؟

قبل‌از شروع توسعه، بازبینه توسعه‌دهندگان ما را ببینید که فهرستی از مراحل را برای کمک به راه‌اندازی یکپارچگی با Google Health API ارائه می‌دهد.

نحوه شروع به کار نیز به نوع توسعه‌دهنده‌ای که هستید بستگی دارد.

توسعه‌دهنده جدید

اگر با Google APIs یا Google Cloud تجربه ندارید یا نیاز به یادآوری دارید، آسان‌ترین و سریع‌ترین راه برای شروع کار این است که یکی از کدآزمایی‌های ما را انجام دهید. ما codelabهای REST را بااستفاده از Visual Studio Code یا OAuth 2.0 Playground ارائه می‌دهیم، همچنین یک codelab ویژه gRPC Python که در آن یاد می‌گیرید چگونه کدهای کمکی کارخواه را بازیابی کنید و تعریف‌های «بافر پروتکل» را تدوین کنید.

REST Codelab (VS Code) REST Codelab (OAuth 2.0 Playground) gRPC Codelab (Python)

توسعه‌دهنده Fitbit

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

این راهنما همچنین روال‌های مطلوب و نمونه‌های میانای کاربر را برای کمک به راهنمایی کاربران در فرایند اصالت‌سنجی مجدد برجسته می‌کند.

پس‌از آن، یا codelab را انجام دهید یا قبل‌از شروع توسعه با یکی از راهنماهای نوع داده ما، تأیید کنید که راه‌اندازی Google Cloud شما کامل است.

«راهنمای انتقال» را بخوانید راه‌اندازی Google Cloud را تکمیل کنید

انتخاب پروتکل

‫Google Health API از هر دو پروتکل REST و RPC پشتیبانی می‌کند تا پایه‌ای مقیاس‌پذیر و با عملکرد بالا برای یکپارچه‌سازی داده‌های سلامت دراختیار توسعه‌دهندگان قرار دهد.

REST

‫REST یک رویکرد طراحی API است که براساس مفاهیم استاندارد وب و قالب‌های قابل‌خواندن برای انسان مانند JSON است. این زبان به‌ویژه برای ساختن میاناهای برنامه‌سازی کاربردی عمومی و برنامه‌های وب مناسب است زیرا با مرورگر سازگار است و به‌طور گسترده پشتیبانی می‌شود. قدرت اصلی آن در سادگی و دردسترس بودن برای توسعه‌دهندگان خارجی است.

gRPC

‫RPC یک سیستم با عملکرد بالا است که از قالب باینری فشرده‌ای به نام «بافرهای پروتکل» برای تسهیل ارتباط بین ماشین‌ها استفاده می‌کند. این پروتکل به‌دلیل کارایی و پشتیبانی از ویژگی‌های پیشرفته مانند جاری‌سازی، برای خدمات خرد داخلی، ارتباط تلفن همراه با زیرینه، و به‌روزرسانی‌های هم‌زمان ایده‌آل است. ‫RPC انتخاب ترجیحی برای سناریوهای با عملکرد بالا یا زمانی است که قراردادهای رابط دقیق موردنیاز است.

برای اطلاعات بیشتر، gRPC دربرابر REST: آشنایی با gRPC،‏ OpenAPI، و REST و زمان استفاده از آن‌ها در طراحی API را ببینید.

کمک هوشواره‌ای و ابزارهای توسعه‌دهنده

می‌توانید از Gemini، دستیار هوش مصنوعی Google، و ابزارهای توسعه‌دهنده داخلی در سراسر این سایت برای تسریع گردش کار Google Health API استفاده کنید. هنگام مرور، از گپ Gemini و «توضیح کد» در پانل اطلاعات برای خلاصه کردن راهنماهای پیچیده، شفاف‌سازی انواع و محدوده‌های داده، یا تطبیق نمونه‌های کد با زبان خودتان استفاده کنید. همچنین می‌توانید درخواست‌های زنده را در «کاوشگر میاناهای برنامه‌سازی کاربردی» آزمایش کنید و از پاسخ‌های JSON به‌عنوان بافت پیام‌واره برای تولید منطق تجزیه استفاده کنید.

اگر با ابزارهای مجهز به هوش مصنوعی مثل Antigravity،‏ Cursor،‏ Claude Code، یا کارگزاران سفارشی توسعه می‌دهید، می‌توانید هر صفحه‌ای را به‌صورت Markdown صادر کنید یا سرور MCP «دانش توسعه‌دهندگان» را ادغام کنید تا محیطتان به مستندات Google Health API دسترسی مستقیم داشته باشد. از این گردش‌های کار برای تولید کد کارخواه یا عیب‌یابی خطاها استفاده کنید. برای کسب اطلاعات بیشتر، دستیار هوش مصنوعی و ابزارهای توسعه‌دهنده را ببینید.

منابع

علاوه‌بر شروع کار، این سایت دارای منابع جامعی برای کمک به توسعه و انتقال است.

  • پشتیبانی: به کمک نیاز دارید؟ در صفحه پشتیبانی به تالارهای گفتمان انجمن و «ردیاب مشکل» عمومی ما دسترسی پیدا کنید.
  • ابزار برابری Google Health API: از این ابزار برای مقایسه نقاط پایانی و عملکرد بین Fitbit Web API و Google Health API استفاده کنید. همچنین دارای فایل زمینه‌ای است که می‌توانید مستقیماً با یک مدل زبانی بزرگ یا به‌عنوان بخشی از فایل Agents.md در ابزار هوش مصنوعی موردنظرتان استفاده کنید.
  • مرجع میانای برنامه‌سازی کاربردی: مستندات مرجع REST کامل.