מתחילים

ברוכים הבאים אל 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, או שאתם צריכים רענון, הדרך הכי קלה ומהירה להתחיל היא לעבור על ה-codelab. במדריך הזה נסביר איך להגדיר פרויקט בענן של Google, לקוח אינטרנט של OAuth 2.0 ואיך להשתמש ב-Visual Studio Code כדי לבצע את הקריאה הראשונה ל-Google Health API.

ל-Codelab

מפתח 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.

משאבים

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

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