פעילויות באתר

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

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

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

  • שם תיאורי וידידותי (לדוגמה, "בוקר בבוקר" )
  • תיאור
  • מזהה ייחודי
  • סוג הפעילות של התיעוד (למשל, ריצה)

יתרונות השימוש בסשנים

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

קבלת הרשאת משתמש עבור פעילויות באתר

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

Android

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

    val fitnessOptions = FitnessOptions.builder()
        .accessActivitySessions(FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
        .build()

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

REST

ניתן לבקש היקפים באופן הבא:

  • סשנים עם סוגי פעילות שינה:
    • https://www.googleapis.com/auth/fitness.sleep.read
    • https://www.googleapis.com/auth/fitness.sleep.write
  • כל שאר הסשנים:
    • https://www.googleapis.com/auth/fitness.activity.read
    • https://www.googleapis.com/auth/fitness.activity.write

שימוש בסשנים

Android

אפשר להשתמש ב-Sessions API כדי:

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

REST

אפשר להשתמש ב-Sessions API כדי:

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

אופן הפעולה של מערכי נתונים ופלחים עם ביקורים

ב-Google Fit:

  • מערך נתונים מייצג קבוצה של נקודות נתונים ממקור נתונים מסוים במהלך תקופת זמן ספציפית. ניתן להוסיף מערכי נתונים משלהם. אבל אם אתם יוצרים סשן, יכול להיות שיהיה קל יותר ליצור את הסשן ואת מערכי הנתונים יחד.
  • פלח מקבץ את מערכי הנתונים במהלך ביקור לפי הפעילות המדויקת שהמשתמש ביצע. לדוגמה, אם המשתמש עוקב אחר מסלול של 30 דקות (הסשן) אבל הולך קצת במשך הזמן הזה, המצב עשוי להתחלק לפלחים. היה קטע לריצה, אחר כך להפסקה ולהליכה שוב.
איור 1: אפליקציות שונות מוסיפות ביקורים ומערכי נתונים ל[חנות הכושר].

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

  • באפליקציה א' נוספו מערכי הנתונים A1 ו-A2 יחד עם ביקור 1 ו-A3 ללא קשר לביקורים כלשהם.
  • אפליקציה ב' הכניסה את מערכי הנתונים B1 ו-B2 יחד עם 'סשן 2'.
  • אפליקציה ג' הכניסה את מערך הנתונים C1 ללא קשר לביקורים כלשהם.

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

  • מערך נתונים A1
  • מערך נתונים A2
  • החלק של מערך הנתונים A3 בין t1 ל-t2
  • החלק של מערך הנתונים C1 בין t1 ל-t2

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

יצירת ביקורים

ניתן ליצור ביקורים בכמה דרכים שונות:

  • האפליקציה שלכם יכולה ליצור סשנים באופן פעיל באחת מהדרכים הבאות:
    • בזמן אמת כשמשתמש עוקב אחר פעילות במכשיר באופן פעיל (Android בלבד), או
    • על ידי הוספה ידנית של התוסף.
  • כשמשתמש מוסיף אימון כושר או פעילות באופן ידני באפליקציית Google Fit.

מתי כדאי ליצור סשן?

רוצה להוסיף נתוני שינה?

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

פעילויות קריאה

האפליקציה יכולה לקרוא סשנים בכמה דרכים:

  • לחפש סשן ספציפי שנוצר או נוסף על ידי
    • שם או
    • ID
  • לחפש את כל הסשנים שנוצרו או נוספו, לפי תקופת זמן
  • חיפוש כל הסשנים הזמינים שנוצרו על ידי כל האפליקציות (כולל Google Fit) לפי תקופת זמן

אילו מקורות יצרו סשן?

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

Android

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

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

למידע נוסף על חיפוש המקור שיצר ביקור.

REST

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

למידע נוסף על חיפוש המקור שיצר ביקור.