Users.sessions: update

הערה: נדרשת הרשאה.

מתעדכן או מוסיף סשן נתון. כדאי לנסות עכשיו.

שליחת בקשה

בקשת HTTP

PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId

פרמטרים

שם הפרמטר	ערך	תיאור
פרמטרים של נתיב
sessionId	string	מזהה הסשן שברצונך ליצור.
userId	string	ליצור ביקורים עבור האדם המזוהה. משתמשים ב-me כדי לציין את המשתמש המאומת. רק me נתמכים בשלב זה.

הרשאה

בקשה זו מחייבת הרשאה במסגרת ההיקף הבא:

היקף ההרשאות
https://www.googleapis.com/auth/fitness.activity.write

מידע נוסף זמין בדף אימות והרשאה.

גוף הבקשה

בגוף הבקשה, יש לספק את הנתונים במבנה הבא:

{
  "id": string,
  "name": string,
  "description": string,
  "startTimeMillis": long,
  "endTimeMillis": long,
  "modifiedTimeMillis": long,
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "activityType": integer,
  "activeTimeMillis": long
}

שם הנכס	ערך	תיאור	הערות
id	string	מזהה שנוצר על ידי הלקוח וייחודי לכל הביקורים שבבעלות המשתמש המסוים הזה.
name	string	שם שניתן לקרוא על ידי המשתמש.
description	string	תיאור לסשן הזה.
startTimeMillis	long	שעת התחלה, באלפיות השנייה מתחילת התקופה, כולל.
endTimeMillis	long	שעת סיום (באלפיות שנייה) מאז התקופה הראשונה, כולל.
modifiedTimeMillis	long	חותמת זמן שמציינת מתי בוצע השינוי האחרון בפעילות באתר.
application	nested object	האפליקציה שיצרה את הסשן.
application.packageName	string	שם החבילה של האפליקציה הזו. המזהה הזה משמש כמזהה ייחודי כשיוצרים אפליקציות ל-Android, אבל לא ניתן לציין אותו ללקוחות REST. מספר הלקוח ב-REST יופיע במזהי מקור הנתונים של מקור הנתונים, במקום packageName.
application.version	string	גרסת האפליקציה. יש לעדכן את השדה הזה בכל פעם שהאפליקציה משתנה בצורה שמשפיעה על חישוב הנתונים.
application.detailsUrl	string	URI אופציונלי שניתן להשתמש בו כדי לקשר חזרה לאפליקציה.
application.name	string	השם של האפליקציה. זו דרישה ללקוחות Google REST, אבל אנחנו לא אוכפים ייחודיות בשם זה. הוא מספק לצורך נוחות מפתחים אחרים שרוצים לזהות איזה REST יצר אפליקציה או מקור נתונים.
activityType	integer	סוג הפעילות שסשן זה מייצג.
activeTimeMillis	long	משך הפעילות. המאפיין start_time_millis ו-end_time_millis מגדירים את זמן הסשן המלא, אבל הזמן הפעיל יכול להיות קצר יותר ומוגדר כ-active_time_millis. אם ידוע משך הזמן של חוסר פעילות במהלך הסשן, צריך להוסיף אותו גם באמצעות נקודת נתונים של com.google.activity.Segment עם ערך של פעילות STILL

תשובה

אם השיטה הזו מוצלחת, היא מחזירה גוף תגובה עם המבנה הבא:

{
  "id": string,
  "name": string,
  "description": string,
  "startTimeMillis": long,
  "endTimeMillis": long,
  "modifiedTimeMillis": long,
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "activityType": integer,
  "activeTimeMillis": long
}

שם הנכס	ערך	תיאור	הערות
id	string	מזהה שנוצר על ידי הלקוח וייחודי לכל הביקורים שבבעלות המשתמש המסוים הזה.
name	string	שם שניתן לקרוא על ידי המשתמש.
description	string	תיאור לסשן הזה.
startTimeMillis	long	שעת התחלה, באלפיות השנייה מתחילת התקופה, כולל.
endTimeMillis	long	שעת סיום (באלפיות שנייה) מאז התקופה הראשונה, כולל.
modifiedTimeMillis	long	חותמת זמן שמציינת מתי בוצע השינוי האחרון בפעילות באתר.
application	nested object	האפליקציה שיצרה את הסשן.
application.packageName	string	שם החבילה של האפליקציה הזו. המזהה הזה משמש כמזהה ייחודי כשיוצרים אפליקציות ל-Android, אבל לא ניתן לציין אותו ללקוחות REST. מספר הלקוח ב-REST יופיע במזהי מקור הנתונים של מקור הנתונים, במקום packageName.
application.version	string	גרסת האפליקציה. יש לעדכן את השדה הזה בכל פעם שהאפליקציה משתנה בצורה שמשפיעה על חישוב הנתונים.
application.detailsUrl	string	URI אופציונלי שניתן להשתמש בו כדי לקשר חזרה לאפליקציה.
application.name	string	השם של האפליקציה. זו דרישה ללקוחות Google REST, אבל אנחנו לא אוכפים ייחודיות בשם זה. הוא מספק לצורך נוחות מפתחים אחרים שרוצים לזהות איזה REST יצר אפליקציה או מקור נתונים.
activityType	integer	סוג הפעילות שסשן זה מייצג.
activeTimeMillis	long	משך הפעילות. המאפיין start_time_millis ו-end_time_millis מגדירים את זמן הסשן המלא, אבל הזמן הפעיל יכול להיות קצר יותר ומוגדר כ-active_time_millis. אם ידוע משך הזמן של חוסר פעילות במהלך הסשן, צריך להוסיף אותו גם באמצעות נקודת נתונים של com.google.activity.Segment עם ערך של פעילות STILL

רוצה לנסות?

כדי לקרוא לשיטה הזו על נתונים בזמן אמת ולראות את התגובה, אתם צריכים להשתמש ב-APIs Explorer.