עדכון של מקור הנתונים שצוין. לא ניתן לשנות את המאפיינים 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 |
למידע נוסף, עיין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מציינים משאב Users.dataSources עם המאפיינים הבאים:
שם הנכס | ערך | תיאור | הערות |
---|---|---|---|
המאפיינים הנדרשים | |||
application |
nested object |
מידע על אפליקציה שמזינה נתוני חיישנים לפלטפורמה. | |
application.name |
string |
שם האפליקציה הזו. הדרישה הזו חלה על לקוחות REST, אבל אנחנו לא אוכפים את הייחודיות של השם הזה. הוא ניתן למפתחים אחרים שרוצים לזהות איזה REST יצר אפליקציה או מקור נתונים, מטעמי נוחות. | |
dataStreamId |
string |
מזהה ייחודי של מקור הנתונים שנוצר על ידי מקור הנתונים הזה. המזהה כולל:
הפורמט המדויק של מזהה מקור הנתונים שנוצר על ידי אפליקציה ל-Android הוא: type:dataType.name הפורמט המדויק של מזהה מקור הנתונים שנוצר על ידי לקוח REST הוא: type:dataType.name אם השדה האופציונלי כלשהו שמרכיבים את מזהה מקור הנתונים חסר, הוא יושמט ממזהה מקור הנתונים. המזהה המינימלי של מקור נתונים בר-קיימא יהיה: type:dataType.name:developer פרויקט מספר לסיום, מספר פרויקט המפתח ומזהה ה-UID של המכשיר יעוותו (obfuscation) כשייקראו על ידי לקוח REST או Android שלא יצר את מקור הנתונים. רק היוצר של מקור הנתונים יראה את מספר פרויקט המפתח בצורה ברורה ורגילה. כלומר, לקוח יראה קבוצה של data_stream_id שונה מזו של לקוח אחר עם פרטי כניסה שונים. |
|
dataType |
nested object |
סוג הנתונים מגדיר את הסכימה לזרם נתונים שנאסף על ידי ה-Fitness API, מתווסף אליו או נשלח אליו שאילתות. | |
dataType.field[] |
list |
שדה מייצג מאפיין אחד של סוג נתונים. | |
dataType.field[].format |
string |
הפורמטים הנתמכים השונים לכל שדה בסוג נתונים.
הערכים הקבילים הם:
|
|
dataType.field[].name |
string |
מגדיר את השם והפורמט של הנתונים. בניגוד לשמות של סוגי נתונים, שמות השדות לא ממוינים לפי מרחב שמות, והם צריכים להיות ייחודיים רק בסוג הנתונים. | |
dataType.name |
string |
לכל סוג נתונים יש שם ייחודי עם מרחב שמות. כל סוגי הנתונים במרחב השמות של com.google משותפים כחלק מהפלטפורמה. | |
device |
nested object |
ייצוג של מכשיר משולב (כמו טלפון או גאדג'ט לביש) שיכול להכיל חיישנים. | |
device.manufacturer |
string |
יצרן המוצר/החומרה. | |
device.model |
string |
שם הדגם של המכשיר שגלוי למשתמש הקצה. | |
device.type |
string |
קבוע שמייצג את סוג המכשיר.
הערכים הקבילים הם:
|
|
device.uid |
string |
המספר הסידורי או מזהה ייחודי אחר של החומרה. השדה הזה מעורפל (obfuscation) כשמתבצעת קריאה על ידי לקוח REST או Android שלא יצר את מקור הנתונים. רק היוצר של מקור הנתונים יראה את השדה uid בצורה ברורה ורגילה. הערפול קוד (obfuscated) שומר על שוויון. כלומר, ניתנים שני מזהים: אם id1 == id2, obfuscated(id1) == obfuscated(id2). |
|
device.version |
string |
מחרוזת גרסה לחומרה/תוכנה של המכשיר. | |
type |
string |
קבוע שמתאר את הסוג של מקור הנתונים הזה. שדה זה מציין אם מקור הנתונים הזה מייצר נתונים גולמיים או נגזרים.
הערכים הקבילים הם:
|
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה משאב Users.dataSources בגוף התגובה.
רוצה לנסות?
צריך להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה.