Users.dataSources: create

属しているすべてのデータソースに対して一意の新しいデータソースを作成する 付与します。

データソースは、センサーデータの一意のソースです。データソースは センサーから送られる未加工データも抽出できます。。 他のデータを変換または結合して作成された派生データも公開できる あります。同じデータ型に対して複数のデータソースが存在してもかまいません。すべてのデータ Fitness API から挿入または読み取られたすべてのデータセットのポイントに データソースです。

各データソースは、データセット更新の固有のストリームを生成し、 一意のデータソース識別子です。データソースに加えられたすべての変更が 同じ ID の更新されたバージョンで収集されたデータが アプリ/デバイスは同じデータに属していると見なすことができる あります。

データソースは、サーバーによって生成された文字列を使用して、 作成されます。dataStreamId このメソッドを呼び出すときは、フィールドを設定しないでください。これは、 サーバーにより正しい形式で自動生成されます。条件 dataStreamId が設定されている場合は、 表示されます。この形式は、 順序があります。一致しない場合、リクエストは エラーが発生して失敗します。

既知の型ではない DataType（ 「com.google.」など）は、カスタムデータ型の DataSource を作成します。 カスタムデータ型は、それを作成したアプリケーションのみが読み取ることができます。 カスタムデータ型は非推奨になりました。標準のデータ型を使用する してください。

データソース ID に含まれるデータソース フィールドに加えて、 データの作成時に認証されるデベロッパー プロジェクト番号 含まれます。このデベロッパー プロジェクト番号は、読み取り時に難読化されます 他のデベロッパーが公開データタイプを読み取ることはありません。 こちらから今すぐお試しください。

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/fitness/v1/users/userId/dataSources

パラメータ

パラメータ名 値 説明
パスパラメータ
userId string 特定された人物のデータソースを作成します。me の用途 認証されたユーザーを示します。現時点でサポートされているのは me のみです あります。

承認

このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。

範囲
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 によって収集、挿入、または Fitness API からクエリされるデータ ストリームのスキーマを定義します。
dataType.field[] list フィールドは、データ型の 1 つのディメンションを表します。
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 フィールドは、明確な標準形式でデータソース作成者にのみ表示されます。

難読化では等式が維持されます。つまり、2 つの ID が与えられた場合、id1 == id2 の場合、obfuscated(id1) == obfuscated(id2) します。
device.version string デバイスのハードウェア/ソフトウェアのバージョン文字列です。
type string このデータソースのタイプを表す定数。このデータソースが元データを生成するのか、派生データを生成するのかを示します。

有効な値は次のとおりです。
  • "derived"
  • 「raw」

レスポンス

成功すると、このメソッドはレスポンスの本文で Users.dataSources リソースを返します。

試してみよう:

以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。