Users.dataSources: update

עדכון מקור הנתונים שצוין. לא ניתן לשנות את המאפיינים dataStreamId, dataType, type, dataStreamName ו-device, מלבד version.

מקורות הנתונים מזוהים לפי dataStreamId שלהם. כדאי לנסות עכשיו.

שליחת בקשה

בקשת HTTP

PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId

פרמטרים

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

הרשאה

הבקשה הזו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים:

היקף ההרשאות
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.write

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

גוף הבקשה

בגוף הבקשה, מספקים משאב User.dataSources עם המאפיינים הבאים:

שם הנכס ערך תיאור הערות
מאפיינים נדרשים
application nested object מידע על אפליקציה שמזינה נתוני חיישנים בפלטפורמה.
application.name string השם של האפליקציה. זו דרישה ללקוחות Google REST, אבל אנחנו לא אוכפים ייחודיות בשם זה. הוא מספק לצורך נוחות מפתחים אחרים שרוצים לזהות איזה REST יצר אפליקציה או מקור נתונים.
dataStreamId string מזהה ייחודי של מקור הנתונים שנוצר על ידי מקור הנתונים הזה. המזהה כולל:

  • שם היצרן, הדגם והמספר הסידורי (UID) של המכשיר הפיזי.
  • שם החבילה או השם של האפליקציה. המערכת משתמשת בשם החבילה כשמקור הנתונים נוצר על ידי אפליקציה ל-Android. נעשה שימוש במספר הפרויקט למפתחים כאשר מקור הנתונים נוצר על ידי לקוח REST.
  • סוג מקור הנתונים.
  • שם מקור הנתונים.
שימו לב שלא כל המאפיינים של מקור הנתונים משמשים כחלק ממזהה מקור הנתונים. באופן ספציפי, גרסת החומרה/האפליקציה לא בשימוש. כך אנחנו יכולים לשמר את אותו שידור חי באמצעות עדכוני גרסה. פירוש הדבר הוא ששני אובייקטים של מקור נתונים יכולים לייצג את אותו מקור נתונים, גם אם הם לא שווים.

הפורמט המדויק של מזהה מקור הנתונים שנוצר על ידי אפליקציה ל-Android הוא: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

הפורמט המדויק של המזהה של מקור הנתונים שנוצר על ידי לקוח REST הוא: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

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

לבסוף, מספר הפרויקט של המפתח ו-UID של המכשיר מעורפלים כאשר הם נקראים על ידי לקוח REST או Android שלא יצר את מקור הנתונים. רק היוצר של מקור הנתונים יראה את מספר הפרויקט של המפתח בפורמט ברור ורגיל. המשמעות היא שלקוח יראה קבוצה שונה של data_stream_id מלקוח אחר עם פרטי כניסה שונים.

dataType nested object סוג הנתונים מגדיר את הסכימה של מקור נתונים נאסף על ידי כושר ה-API, מוכנס אליו או נשלח ממנו שאילתה.
dataType.field[] list שדה מייצג מאפיין אחד של סוג נתונים.
dataType.field[].format string הפורמטים הנתמכים השונים לכל שדה בסוג הנתונים.

הערכים הקבילים הם:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string מגדיר את השם ואת הפורמט של הנתונים. בניגוד לשמות של סוגי נתונים, שמות השדות לא מרווחים, והם צריכים להיות ייחודיים רק בתוך סוג הנתונים.
dataType.name string לכל סוג נתונים יש שם ייחודי, מרחב שמות. כל סוגי הנתונים במרחב השמות com.google. של הפלטפורמה משותפים.
device nested object ייצוג של מכשיר משולב (כמו טלפון או גאדג'ט לביש) שיכול להחזיק את החיישנים.
device.manufacturer string היצרן של המוצר/החומרה.
device.model string שם הדגם של משתמש הקצה שגלוי למכשיר.
device.type string קבוע שמייצג את סוג המכשיר.

הערכים הקבילים הם:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string המספר הסידורי או מזהה ייחודי אחר של החומרה. השדה הזה מעורפל כאשר הוא נקרא על ידי לקוח REST או Android שלא יצר את מקור הנתונים. רק היוצר של מקור הנתונים יראה את שדה המזהה הקבוע בצורה ברורה ורגילה.

הטשטוש (obfuscation) משמר את השוויון; כלומר, מקבלים שני מזהים, אם id1 == id2, obfuscated(id1) == obfuscated(id2).

device.version string מחרוזת גרסה של החומרה/תוכנה של המכשיר.
type string קבוע שמתאר את הסוג של מקור הנתונים. מציין אם מקור הנתונים הזה מפיק נתונים גולמיים או נגזרים.

הערכים הקבילים הם:
  • "derived"
  • "raw"

תשובה

אם היא מוצלחת, השיטה הזו מחזירה משאב User.dataSources בגוף התגובה.

רוצה לנסות?

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