עדכון מקור הנתונים שצוין. לא ניתן לשנות את המאפיינים 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 |
מזהה ייחודי של מקור הנתונים שנוצר על ידי מקור הנתונים הזה. המזהה כולל:
הפורמט המדויק של מזהה מקור הנתונים שנוצר על ידי אפליקציה ל-Android הוא: type:dataType.name הפורמט המדויק של המזהה של מקור הנתונים שנוצר על ידי לקוח REST הוא: type:dataType.name אם אחד מהשדות האופציונליים שמהם מורכב מזהה מקור הנתונים חסר, הוא יושמט מהמזהה של מקור הנתונים. המזהה המינימלי של מקור הנתונים הוא: type:dataType.name:developer מספר פרויקט לבסוף, מספר הפרויקט של המפתח ו-UID של המכשיר מעורפלים כאשר הם נקראים על ידי לקוח REST או Android שלא יצר את מקור הנתונים. רק היוצר של מקור הנתונים יראה את מספר הפרויקט של המפתח בפורמט ברור ורגיל. המשמעות היא שלקוח יראה קבוצה שונה של data_stream_id מלקוח אחר עם פרטי כניסה שונים. |
|
dataType |
nested object |
סוג הנתונים מגדיר את הסכימה של מקור נתונים נאסף על ידי כושר ה-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 |
המספר הסידורי או מזהה ייחודי אחר של החומרה. השדה הזה מעורפל כאשר הוא נקרא על ידי לקוח REST או Android שלא יצר את מקור הנתונים. רק היוצר של מקור הנתונים יראה את שדה המזהה הקבוע בצורה ברורה ורגילה. הטשטוש (obfuscation) משמר את השוויון; כלומר, מקבלים שני מזהים, אם id1 == id2, obfuscated(id1) == obfuscated(id2). |
|
device.version |
string |
מחרוזת גרסה של החומרה/תוכנה של המכשיר. | |
type |
string |
קבוע שמתאר את הסוג של מקור הנתונים. מציין אם מקור הנתונים הזה מפיק נתונים גולמיים או נגזרים.
הערכים הקבילים הם:
|
תשובה
אם היא מוצלחת, השיטה הזו מחזירה משאב User.dataSources בגוף התגובה.
רוצה לנסות?
כדי לקרוא לשיטה הזו על נתונים בזמן אמת ולראות את התגובה, אתם צריכים להשתמש ב-APIs Explorer.