Users.dataSources: update

指定したデータソースを更新します。dataStreamId、 dataType さん、type さん、dataStreamName さん、 device プロパティ（version を除く） 変更することはできません。

データソースは dataStreamId で識別されます。 こちらから今すぐお試しください。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名 値 説明
パスパラメータ
dataSourceId string 更新するデータソースのデータ ストリーム ID。
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 を確認したい他のデベロッパーのために便宜上提供されています。
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 のセットが表示されます。
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 を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。