Users.dataSources: create

建立不重複的新資料來源，供所有歸屬中的資料來源使用 提供給該使用者

資料來源是感應器資料的獨特來源。資料來源 來自本機或隨附裝置的硬體感應器的原始資料。他們 也可以公開因轉換或合併其他資料而建立的衍生資料 資料來源同一個資料類型可以有多個資料來源。所有資料 插入或讀取 Fitness API 的每個資料集都有一個資料點 相關的資料來源

每個資料來源都會產生不重複的資料集更新串流， 不重複的資料來源 ID並非所有資料來源變更都會影響 資料串流 ID，讓新版相同 應用程式/裝置仍可視為相同的資料 來源。

系統會使用伺服器產生的字串辨識資料來源， 專屬於要建立來源的內容dataStreamId 欄位不得在叫用這個方法時設定。這項服務 是由伺服器自動產生正確的格式。如果 已設定 dataStreamId，且必須符合 產生的值這種格式是 且具有特定順序如果不相符 就會失敗，並顯示錯誤。

指定非已知類型的 DataType (開頭為 「com.google.」)，建立含有自訂資料類型的 DataSource。 只有建立自訂資料類型的應用程式才能讀取。 自訂資料類型已淘汰；使用標準資料類型 。

除了資料來源 ID 中包含的資料來源欄位以外， 開發人員專案編號；這是在建立資料時通過驗證的開發人員專案編號 來源。讀取時，這個開發人員專案編號會經過模糊處理 其他任何開發人員讀取公開資料類型的情況 立即試用。

要求

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 硬體的序號或其他專屬 ID。任何未建立資料來源的 REST 或 Android 用戶端讀取時，這個欄位會模糊處理。只有資料來源建立者才會看到清楚一般格式的 uid 欄位。

此模糊處理可維持相等性；也就是兩個 ID。如果 id1 == id2，obfuscated(id1) == obfuscated(id2)。
device.version string 裝置硬體/軟體的版本字串。
type string 說明這個資料來源類型的常數。指出這個資料來源會產生原始或衍生的資料。

可接受的值為：
  • 「derived」
  • 「raw」

回應

如果成功，這個方法會在回應主體中傳回 Users.dataSources 資源。

試試看！

使用下方的 APIs Explorer，針對即時資料呼叫這個方法，看看會有什麼結果。