指定されたデータソースを更新します。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 には次のものが含まれます。
Android アプリケーションによって作成されるデータ ストリーム ID の正確な形式は次のとおりです。type:dataType.name REST クライアントによって作成されるデータ ストリーム ID の正確な形式は次のとおりです。type:dataType.name データ ストリーム 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 |
データ型の各フィールドでサポートされるさまざまな形式。 有効な値は次のとおりです。
|
|
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 フィールドは、データソースの作成者に対してのみ通常の形式で表示されます。 難読化では等価性が維持されます。つまり、id1 == id2 の場合、obfuscated(id1) == obfuscated(id2) になります。 |
|
device.version |
string |
デバイスのハードウェアとソフトウェアのバージョン文字列。 | |
type |
string |
このデータソースのタイプを表す定数。このデータソースが元データを生成するか、派生データを生成するかを示します。
有効な値は次のとおりです。
|
レスポンス
成功すると、このメソッドはレスポンスの本文で Users.dataSources リソースを返します。
試してみよう:
以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。