רשימת משימות למפתחים

רשימת המשימות הזו מספקת סקירה כללית של השלבים המומלצים להשקת האפליקציה עם שילוב של Google Health API.

1. לפני שמתחילים

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

‫בדיקת מדיניות Google Health API: חשוב לוודא שתרחיש השימוש שלך עומד בדרישות של התנאים וההגבלות למפתחים של Google Health API ושל המדיניות של Google Health API בנושא נתוני משתמשים ומפתחים.

מתכננים את חוויית המשתמש: אם אתם מעבירים משתמשים מ-Fitbit Web API, כדאי לעיין בשיטות המומלצות במדריך להעברת נתונים בנושא טיפול באימות מחדש של משתמשים.

2. הגדרת השילוב

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

הגדרת מסך ההסכמה ל-OAuth: במסוף Google Cloud, מגדירים את מסך ההסכמה ל-OAuth עם פרטי האפליקציה, המיתוג וקישורים למדיניות הפרטיות ולתנאים ולהגבלות של האפליקציה.

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

3. פיתוח ובדיקה

שליחת קריאה ראשונה ל-API: אם אתם חדשים ב-Google Health API, תוכלו להיעזר ב-Codelab כדי לשלוח את הקריאה הראשונה ל-API תוך דקות.

מעבר מ-Fitbit Web API: אם אתם עוברים מ-Fitbit Web API, כדאי לעיין במדריך להעברה ולהשתמש בכלי להשוואה כדי להשוות בין ממשקי ה-API.

הטמעת OAuth 2.0: מטמיעים הרשאה באמצעות OAuth 2.0 כדי לקבל את הסכמת המשתמש ואסימוני API. כדי לפשט את ההטמעה, אפשר להשתמש בספריות לקוח.

הוספת משתמשי בדיקה: בזמן שהאפליקציה במצב 'בדיקה' ב-Google Cloud, מוסיפים משתמשי בדיקה כדי לבדוק את השילוב עם חשבונות ברשימת ההיתרים.

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

טיפול בשגיאות: כדאי לעיין במדריך לפתרון בעיות כדי לראות שגיאות נפוצות ואיך לטפל בהן.

שימוש ב-webhooks למינויים: שימוש ב-Subscription API כדי לקבל התראות בזמן אמת במקום לבצע סקרים. העברת התראות נכנסות לתור ועיבוד שלהן בנפרד. שיטות מומלצות ל-webhook

4. הכנות להשקה

אימות OAuth: אם האפליקציה צריכה לתמוך ביותר מ-100 משתמשים, או שאתם מוכנים להשיק אותה לציבור, אתם צריכים לשלוח אותה לאימות OAuth. התהליך הזה יכול להימשך כמה ימים והוא כולל בדיקת אבטחה של צד שלישי ואימות של מדיניות הפרטיות והתנאים וההגבלות של האפליקציה.

העברה של Fitbit Web API: אם מבצעים העברה, חשוב לוודא שתהליך האימות מחדש של המשתמשים שמועברים מתבצע בצורה חלקה, בהתאם להמלצות שבמדריך להעברה.

5. השקה ותחזוקה

פרסום האפליקציה: אחרי השלמת האימות של OAuth, מפרסמים את האפליקציה בקטע 'בשלב הייצור' במסוף Google Cloud כדי להסיר את מגבלת 100 המשתמשים.

מעקב: מעקב אחר השימוש ב-API ושיעורי השגיאות במסוף Google Cloud.

להתעדכן: כדאי לעקוב אחרי הערות על הגרסה כדי לקבל מידע על עדכונים והוצאות משימוש של ממשקי API.