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 クライアントによって作成された場合に使用されます。
  • データソースのタイプ。
  • データソースのストリーム名。
なお、データソースのすべての属性がストリーム ID の一部として使用されるわけではありません。特に、ハードウェア/アプリケーションのバージョンは使用されません。これにより、バージョンの更新後も同じストリームを保持できます。つまり、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 プロジェクト番号です。

最後に、データソースを作成していない REST または Android クライアントによって読み取られると、デベロッパーのプロジェクト番号とデバイスの UID が難読化されます。デベロッパー プロジェクト番号は、データソースの作成者のみが明確かつ標準的な形式で表示されます。つまり、クライアントには、認証情報が異なる別のクライアントとは異なる data_stream_id のセットが表示されます。
dataType nested object データ型は、Fitness API によって収集、挿入、またはクエリされるデータのストリームのスキーマを定義します。
dataType.field[] list フィールドは 1 つのデータ型の 1 つのディメンションを表します。
dataType.field[].format string データ型の各フィールドでサポートされる形式。

有効な値は次のとおりです。
  • 「blob」
  • 「floatList」
  • 「floatPoint」
  • 「integer」
  • 「integerList」
  • 「map」
  • 「string」
dataType.field[].name string データの名前と形式を定義します。データ型名とは異なり、フィールド名は Namespace ではなく、データ型内で一意である必要があります。
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、難読化（id1）== 難読化（id2）となります。
device.version string デバイスのハードウェア/ソフトウェアのバージョン文字列。
type string このデータソースのタイプを記述する定数。このデータソースが元データまたは派生データを生成するかどうかを指定します。

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

レスポンス

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

お試しください。

以下の API Explorer を使ってライブデータ上でこのメソッドを呼び出し、レスポンスを確認します。