Users.dataSources: create

יצירה של מקור נתונים חדש וייחודי בכל מקורות הנתונים השייכים למשתמש הזה.

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

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

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

ציון סוג DataType שאינו ידוע (מתחיל ב- 'com.google.') ייצור מקור נתונים עם סוג נתונים מותאמים אישית. סוגי נתונים בהתאמה אישית ניתנים לקריאה רק על ידי האפליקציה שיצרה אותם. סוגי נתונים בהתאמה אישית הוצאו משימוש. משתמשים בסוגי נתונים סטנדרטיים במקום זאת.

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

בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר ערך תיאור
פרמטרים של נתיב
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

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

גוף הבקשה

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

שם הנכס ערך תיאור הערות
המאפיינים הנדרשים
application nested object מידע על אפליקציה שמזינה נתוני חיישנים לפלטפורמה.
application.name string השם של האפליקציה הזו. זה שדה חובה בלקוחות REST, אבל אנחנו לא אוכפים את הייחודיות של השם הזה. מטעמי נוחות, מפתחים אחרים שרוצים לזהות איזה REST יצר אפליקציה או מקור נתונים.
dataType nested object סוג הנתונים מגדיר את הסכימה של מקור נתונים שנאסף על ידי ממשק ה-Fitness 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 שלא יצר את מקור הנתונים. רק יוצר מקור הנתונים יראה את שדה ה-uid בצורה ברורה ורגילה.

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

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

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

תשובה

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

נסה בעצמך!

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