属しているすべてのデータソースに対して一意の新しいデータソースを作成する
付与します。
データソースは、センサーデータの一意のソースです。データソースは
センサーから送られる未加工データも抽出できます。。
他のデータを変換または結合して作成された派生データも公開できる
あります。同じデータ型に対して複数のデータソースが存在してもかまいません。すべてのデータ
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 |
データ型の各フィールドでサポートされているさまざまな形式。
有効な値は次のとおりです。
|
|
dataType.field[].name |
string |
データの名前と形式を定義します。データ型の名前とは異なり、フィールド名は名前空間方式ではなく、データ型内で一意であることのみが必要です。 | |
dataType.name |
string |
各データ型には一意の名前空間付きの名前があります。com.google 名前空間内のすべてのデータ型は、プラットフォームの一部として共有されます。 | |
device |
nested object |
センサーを保持できる統合デバイス（スマートフォンやウェアラブルなど）を表します。 | |
device.manufacturer |
string |
製品やハードウェアのメーカー。 | |
device.model |
string |
エンドユーザーに表示されるデバイスのモデル名。 | |
device.type |
string |
デバイスのタイプを表す定数。
有効な値は次のとおりです。
|
|
device.uid |
string |
ハードウェアのシリアル番号またはその他の一意の ID。このフィールドは、データソースを作成していない REST または Android クライアントによって読み取られると難読化されます。uid フィールドは、明確な標準形式でデータソース作成者にのみ表示されます。 難読化では等式が維持されます。つまり、2 つの ID が与えられた場合、id1 == id2 の場合、obfuscated(id1) == obfuscated(id2) します。 |
|
device.version |
string |
デバイスのハードウェア/ソフトウェアのバージョン文字列です。 | |
type |
string |
このデータソースのタイプを表す定数。このデータソースが元データを生成するのか、派生データを生成するのかを示します。
有効な値は次のとおりです。
|
|
レスポンス
成功すると、このメソッドはレスポンスの本文で Users.dataSources リソースを返します。
試してみよう:
以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。