מתחילים

ברוכים הבאים אל Google Health API!

ה-API החדש הזה מבוסס על Google OAuth, ומספק פתרון מאובטח, ידידותי למשתמש וניתן להרחבה לגישה לנתוני בריאות ולניהול שלהם. אלה כמה מהיתרונות:

  • אבטחה משופרת: ה-API החדש תואם להמלצות ולשיטות המומלצות הנוכחיות של Google לתכנון וליישום של ממשקי API, וכך מצמצם את הסיכון לפגיעויות.

  • עקביות: ממשק ה-API החדש פועל לפי עקרונות עיצוב מודרניים של ממשקי API, ומציע חוויית מפתחים עקבית ואינטואיטיבית יותר.

  • התאמה לעתיד

    • יכולת הרחבה: ה-API החדש מתוכנן להתרחב כדי לעמוד בדרישות עתידיות, והוא תומך במספר גדל והולך של משתמשים וסוגי נתונים.
    • תחזוקה: אימוץ גישה סטנדרטית מקל על התחזוקה והעדכון של האפליקציות, ומפחית את החוב הטכני.
    • גישה לתכונות חדשות: המעבר ל-API החדש מאפשר גישה לתכונות ולפונקציות חדשות כשהן יוצאות, וכך לוודא שהאפליקציות מעודכנות ונהנות מהחידושים האחרונים.
    • תאימות: ה-API החדש מתעדכן בהתאם לתקני האבטחה והפרטיות העדכניים ביותר של Google, וכך מצטמצם המאמץ שנדרש כדי לשמור על תאימות האפליקציות.
    • פרטיות הנתונים: מערכת Google OAuth מתוכננת כך שתעמוד בדרישות של תקנות שונות בנושא פרטיות נתונים (לדוגמה, GDPR ו-HIPAA), וכך להקל על המפתחים את הנטל של עמידה בדרישות.

איך מתחילים?

לפני שמתחילים לפתח, כדאי לעיין ברשימת המשימות למפתחים, שכוללת רשימה של שלבים שיעזרו לכם להשיק את השילוב עם Google Health API.

הדרך שבה מתחילים תלויה גם בסוג המפתח.

מפתח חדש

אם אין לכם ניסיון עם ממשקי Google API או עם Google Cloud, או שאתם צריכים רענון, הדרך הכי קלה ומהירה להתחיל היא לעבור על אחד מה-codelabs שלנו. אנחנו מציעים Codelabs של REST באמצעות Visual Studio Code או OAuth 2.0 Playground, וגם Codelab של Python ספציפי ל-gRPC שבו לומדים איך לאחזר stub של לקוח ולבצע קומפילציה של הגדרות Protocol Buffer.

‫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. הפורמט הזה מתאים במיוחד ליצירת ממשקי API ציבוריים ואפליקציות אינטרנט, כי הוא ידידותי לדפדפנים ונתמך באופן נרחב. היתרון העיקרי שלו הוא הפשטות והנגישות שלו למפתחים חיצוניים.

gRPC

‫RPC היא מערכת עם ביצועים גבוהים שמשתמשת בפורמט בינארי קומפקטי שנקרא Protocol Buffers כדי לאפשר תקשורת בין מכונות. הוא אידיאלי למיקרו-שירותים פנימיים, לתקשורת בין אפליקציות לנייד לבין שרתים ולעדכונים בזמן אמת, בגלל היעילות שלו והתמיכה בתכונות מתקדמות כמו סטרימינג. ‫RPC היא הבחירה המועדפת לתרחישים שדורשים ביצועים גבוהים או כשנדרשים חוזי ממשק מחמירים.

מידע נוסף זמין במאמר gRPC vs REST: Understanding gRPC, OpenAPI and REST and when to use them in API design.

כלים מבוססי-AI למפתחים

אתם יכולים להשתמש ב-Gemini, העוזר הדיגיטלי מבוסס-AI של Google, ובכלי פיתוח מובנים באתר הזה כדי להאיץ את תהליך העבודה של Google Health API. במהלך הגלישה, אפשר להשתמש ב-Gemini בצ'אט וב-Code Explain בחלונית המידע כדי לסכם מדריכים מורכבים, להבהיר סוגי נתונים והיקפים או להתאים דוגמאות קוד לשפה שלכם. אפשר גם לבדוק בקשות פעילות ב-APIs Explorer ולהשתמש בתשובות בפורמט JSON כהקשר של הנחיה כדי ליצור לוגיקה של ניתוח.

אם אתם מפתחים באמצעות כלים מבוססי-AI כמו Antigravity,‏ Cursor,‏ Claude Code או סוכנים בהתאמה אישית, אתם יכולים לייצא כל דף כ-Markdown או לשלב את שרת ה-MCP של Developer Knowledge כדי לתת לסביבה שלכם גישה ישירה לתיעוד של Google Health API. אפשר להשתמש בתהליכי העבודה האלה כדי ליצור קוד לקוח או לפתור שגיאות. מידע נוסף זמין במאמר כלים למפתחים וסיוע מבוסס-AI.

משאבים

בנוסף למדריכים לתחילת העבודה, באתר הזה יש משאבים מקיפים שיעזרו לכם בפיתוח ובמיגרציה.

  • תמיכה: דרושה לך עזרה? גישה לפורומים של הקהילה ול-Issue Tracker הציבורי שלנו בדף התמיכה.
  • כלי ההשוואה של Google Health API: אפשר להשתמש בכלי הזה כדי להשוות בין נקודות קצה ופונקציונליות בין Fitbit Web API לבין Google Health API. הוא כולל גם קובץ הקשר שאפשר להשתמש בו ישירות עם מודל שפה גדול (LLM), או כחלק מקובץ Agents.md בכלי ה-AI המועדף.
  • מאמרי העזרה של ה-API: מסמכי עזרה מלאים של REST.