סוגי הנתונים

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

Google Fit מספק קבוצה של סוגי נתונים של בריאות ורווחה במרחב השמות com.google.

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

• קריאה או תצפית באופן מיידי
• נתונים מצטברים עם נתונים סטטיסטיים במהלך פרק זמן מסוים

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

ב-Google Fit אפשר גם להגדיר סוגי נתונים חדשים.

קבוצות של סוגי נתונים

ב-Google Fit יש את סוגי הנתונים הבאים:

סוגי נתונים שגלויים לכולם

לסוגי הנתונים הרגילים שהפלטפורמה מספקת יש את הערך 'com.google' . לדוגמה, com.google.step_count.delta. סוגי הנתונים האלה מתעדכנת קריאה מיידית נתוני בריאות וכושר, כולל פעילות כושר, שינה ותזונה. כל אפליקציה יכולה לבקש את ההרשאות הרלוונטיות לקריאה ולכתיבה בסוגי הנתונים האלה, מלבד כמה סוגי נתוני מיקום שרק האפליקציה שכתבה אותם יכולה לקרוא אותם.

מידע נוסף זמין בדפים הבאים:

• סוגים של נתוני הפעילות
• סוגי נתוני מיקום
• סוגים של נתונים על תזונה

סוגי נתוני בריאות

סוגי הנתונים שסופקו על ידי הפלטפורמה שהגישה אליה הוגבלה עקב מידע שעשוי להיות רגיש. מידע נוסף זמין במאמר סוגי נתוני בריאות.

סוגי נתונים נצברים

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

סוגי נתונים פרטיים בהתאמה אישית

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

שימוש בסוגי נתונים

val nutritionSource = DataSource.Builder()
    .setDataType(DataType.TYPE_NUTRITION)
    ...
    .build()

val nutrients = mapOf(
    Field.NUTRIENT_TOTAL_FAT to 0.4f,
    Field.NUTRIENT_SODIUM to 1f,
    Field.NUTRIENT_POTASSIUM to 422f
)
val banana = DataPoint.builder(nutritionSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_FOOD_ITEM, "banana")
    .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK)
    .setField(Field.FIELD_NUTRIENTS, nutrients)
    .build()

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

היקפי ההרשאות

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

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

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

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

בטבלה הזו אפשר לבדוק אם היקפי ההרשאות שהאפליקציה שלך צריכה גישה אליהם הם רגישים או מוגבלת (וקובעים את האימות השלבים שצריך לבצע):

הוספה של היקפי הרשאות חדשים לאפליקציה קיימת

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

מומלץ לבקש הרשאה מהמשתמשים למשאבים בזמן הצורך. פועלים לפי ההנחיות לבקשה של הרשאה מצטברת.

יש סיכוי גבוה יותר שהמשתמשים יעניקו גישה אם הם יבינו למה האפליקציה שלכם משתמשת בנתונים האלה ואיך היא עושה זאת:

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

מידע נוסף על שיטות מומלצות בנושא הרשאות לאפליקציות ל-Android