Users.dataSources: create

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

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

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

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

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

בנוסף לשדות של מקור הנתונים שכלולים במזהה של מקור הנתונים, כלול מספר הפרויקט למפתחים שאומת בעת יצירת מקור הנתונים. מספר הפרויקט הזה מעורפל (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

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

גוף הבקשה

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

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