Users.dataSources

センサーデータの一意のソースの定義。データソースは、ローカル デバイスまたはコンパニオン デバイスのハードウェア センサーからの元データを公開できます。また、他のデータソースを変換または統合して作成された派生データを公開することもできます。同じデータ型に対して複数のデータソースが存在してもかまいません。このサービスに挿入される、またはこのサービスから読み取られるすべてのデータポイントには、データソースが関連付けられています。

データソースには、ハードウェア デバイスや、データを収集または変換したアプリケーションなど、データを一意に識別するのに十分な情報が含まれています。また、ハードウェアやアプリケーションのバージョン、デバイスの種類など、有用なメタデータも保持されます。

各データソースは、一意の識別子を持つ一意のデータ ストリームを生成します。データソースの変更がすべてストリーム識別子に影響するわけではないため、同じアプリケーションやデバイスのアップデート版によって収集されたデータは同じデータ ストリームに属するものと見なすことができます。

このリソースのメソッドの一覧は、このページの最後に掲載されています。

リソース表現

{
  "dataStreamId": string,
  "name": string,
  "dataStreamName": string,
  "type": string,
  "dataType": {
    "name": string,
    "field": [
      {
        "name": string,
        "format": string,
        "optional": boolean
      }
    ]
  },
  "device": {
    "uid": string,
    "type": string,
    "version": string,
    "model": string,
    "manufacturer": string
  },
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "dataQualityStandard": [
    string
  ]
}
プロパティ名 値 説明 メモ
application nested object センサーデータをプラットフォームにフィードするアプリケーションに関する情報。
application.detailsUrl string アプリにリンクするために使用できる URI（省略可）。
application.name string このアプリケーションの名前。これは REST クライアントでは必須ですが、この名前の一意性は強制しません。これは、アプリケーションやデータソースを作成した REST を確認したい他のデベロッパーのために便宜上提供されています。
application.packageName string このアプリケーションのパッケージ名。Android アプリで作成された場合は一意の識別子として使用されますが、REST クライアントで指定することはできません。REST クライアントでは、packageName ではなく、デベロッパー プロジェクト番号がデータソースのデータ ストリーム ID に反映されます。
application.version string アプリケーションのバージョン。アプリケーションでデータの計算に影響するような変更が加えられるたびに、このフィールドを更新する必要があります。
dataQualityStandard[] list このフィールドは入力しないでください。プラットフォームからのレスポンスには入力されず、クエリでは無視されます。今後のバージョンで完全に削除される予定です。
dataStreamId string このデータソースによって生成されるデータ ストリームの一意の識別子。ID には次のものが含まれます。

  • 実機のメーカー、モデル、シリアル番号（UID）。
  • アプリのパッケージ名または名前。パッケージ名は、データソースが Android アプリで作成されたときに使用されます。デベロッパー プロジェクト番号は、データソースが REST クライアントで作成されたときに使用されます。
  • データソースのタイプ。
  • データソースのストリーム名です。
データソースのすべての属性がストリーム識別子の一部として使用されるわけではありません。特に、ハードウェアやアプリケーションのバージョンは使用されていません。これにより、バージョン アップデート後も同じストリームを維持できます。つまり、等しくなくても 2 つの DataSource オブジェクトが同じデータ ストリームを表すことがあります。

Android アプリケーションによって作成されるデータ ストリーム ID の正確な形式は、type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

REST クライアントによって作成されるデータ ストリーム ID の正確な形式は、type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

です。データ ストリーム ID を構成するオプション フィールドがない場合は、データ ストリーム ID から省略されます。実行可能な最小限のデータ ストリーム ID は「type:dataType.name:developer project number」です。

最後に、デベロッパー プロジェクト番号とデバイス UID は、データソースを作成していない REST クライアントまたは Android クライアントによって読み取られると難読化されます。デベロッパー プロジェクト番号は、データソースの作成者のみに明確かつ通常の形式で表示されます。つまり、クライアントには、認証情報が異なる別のクライアントとは異なる data_stream_ids のセットが表示されます。
dataStreamName string ストリーム名は、この特定のデータソースを、同じ基盤となるプロデューサーの同じタイプのデータソースの中で一意に識別します。ストリーム名の設定は任意ですが、アプリが同じデータ型の 2 つのストリームを公開する場合、またはデバイスに同等のセンサーが 2 つある場合には、必ず設定する必要があります。
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.field[].optional boolean
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 デバイスのハードウェア/ソフトウェアのバージョン文字列です。
name string このデータソースのエンドユーザーに表示される名前。
type string このデータソースのタイプを表す定数。このデータソースが元データを生成するのか、派生データを生成するのかを示します。

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

メソッド

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

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

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

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

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

データソース ID に含まれるデータソース フィールドに加えて、 データの作成時に認証されるデベロッパー プロジェクト番号 含まれます。このデベロッパー プロジェクト番号は、読み取り時に難読化されます 他のデベロッパーが公開データタイプを読み取ることはありません。
delete
指定したデータソースを削除します。次の場合はリクエストが失敗します。 ソースにはすべてのデータポイントが含まれます。
get
指定されたデータソースを返します。
list
OAuth を使用してデベロッパーに表示されるすべてのデータソースをリストします あります。このリストはすべてを網羅しているわけではありません。ユーザーが非公開に 他のデベロッパーにのみ表示されるデータソース、または 使用できます。
update
指定したデータソースを更新します。dataStreamId、 dataType さん、type さん、dataStreamName さん、 device プロパティ（version を除く） 変更できません。

データソースは dataStreamId で識別されます。