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 プロジェクト番号

です。最後に、デベロッパー プロジェクト番号とデバイス UID は、データソースを作成していない REST または Android クライアントによって読み取られると難読化されます。デベロッパーのプロジェクト番号は、データソースの作成者に対してのみ通常の形式で表示されます。つまり、クライアントには、認証情報の異なる別のクライアントとは異なる data_stream_ids セットが表示されます。
dataType nested object データタイプは、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 フィールドは、データソースの作成者に対してのみ通常の形式で表示されます。

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

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

レスポンス

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

試してみよう:

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