Users.dataSources: create

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

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

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

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

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

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

בקשה

בקשת 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 המספר הסידורי או מזהה ייחודי אחר של החומרה. השדה הזה מעורפל (obfuscation) כשמתבצעת קריאה על ידי לקוח REST או Android שלא יצר את מקור הנתונים. רק היוצר של מקור הנתונים יראה את השדה uid בצורה ברורה ורגילה.

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

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

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

תשובה

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

רוצה לנסות?

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