指定したセッションを更新または挿入します。実習をご覧ください。
リクエスト
HTTP リクエスト
PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
パスパラメータ | ||
sessionId |
string |
作成されるセッションの ID。 |
userId |
string |
特定されたユーザーのセッションを作成します。me を使用して、認証済みユーザーを示します。現時点では me のみがサポートされています。
|
認可
このリクエストには、次のスコープによる認証が必要です。
範囲 |
---|
https://www.googleapis.com/auth/fitness.activity.write |
詳細については、認証と認可のページをご覧ください。
リクエスト本文
リクエストの本文には、以下の構造を使用してデータを指定してください。
{ "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long }
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
id |
string |
クライアントが生成し、この特定のユーザーが所有するすべてのセッションで一意の識別子。 | |
name |
string |
人が読める形式のセッション名。 | |
description |
string |
このセッションの説明。 | |
startTimeMillis |
long |
エポックからのミリ秒単位の開始時間(ミリ秒を含む)。 | |
endTimeMillis |
long |
エポックからのミリ秒単位で示した終了時間。 | |
modifiedTimeMillis |
long |
セッションが最後に変更された時刻を示すタイムスタンプ。 | |
application |
nested object |
セッションを作成したアプリケーション。 | |
application.packageName |
string |
このアプリケーションのパッケージ名。Android アプリの作成時に一意の識別子として使用されます。REST クライアントでは指定できません。REST クライアントのデベロッパー プロジェクト番号は、packageName ではなく、データソース データ ストリーム ID に反映されます。 | |
application.version |
string |
アプリケーションのバージョン。データの計算に影響するような方法でアプリケーションが変更されるたびに、このフィールドを更新する必要があります。 | |
application.detailsUrl |
string |
アプリケーションに戻るために使用できる URI(省略可)。 | |
application.name |
string |
このアプリケーションの名前。これは REST クライアントでは必須ですが、この名前の一意性は強制されません。アプリケーションやデータソースを作成した REST を知りたい他のデベロッパーのために用意されており、便宜上提供されています。 | |
activityType |
integer |
このセッションが表すアクティビティのタイプ。 | |
activeTimeMillis |
long |
セッションのアクティブ時間。start_time_millis と end_time_millis は完全なセッション時間を定義しますが、アクティブ時間はこれより短く、active_time_millis で指定できます。セッション中の非アクティブ時間がわかっている場合は、STILL アクティビティ値を持つ com.google.activity.segment データポイントを介して挿入する必要もあります。 |
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{ "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long }
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
id |
string |
クライアントが生成し、この特定のユーザーが所有するすべてのセッションで一意の識別子。 | |
name |
string |
人が読める形式のセッション名。 | |
description |
string |
このセッションの説明。 | |
startTimeMillis |
long |
エポックからのミリ秒単位の開始時間(ミリ秒を含む)。 | |
endTimeMillis |
long |
エポックからのミリ秒単位で示した終了時間。 | |
modifiedTimeMillis |
long |
セッションが最後に変更された時刻を示すタイムスタンプ。 | |
application |
nested object |
セッションを作成したアプリケーション。 | |
application.packageName |
string |
このアプリケーションのパッケージ名。Android アプリの作成時に一意の識別子として使用されます。REST クライアントでは指定できません。REST クライアントのデベロッパー プロジェクト番号は、packageName ではなく、データソース データ ストリーム ID に反映されます。 | |
application.version |
string |
アプリケーションのバージョン。データの計算に影響するような方法でアプリケーションが変更されるたびに、このフィールドを更新する必要があります。 | |
application.detailsUrl |
string |
アプリケーションに戻るために使用できる URI(省略可)。 | |
application.name |
string |
このアプリケーションの名前。これは REST クライアントでは必須ですが、この名前の一意性は強制されません。アプリケーションやデータソースを作成した REST を知りたい他のデベロッパーのために用意されており、便宜上提供されています。 | |
activityType |
integer |
このセッションが表すアクティビティのタイプ。 | |
activeTimeMillis |
long |
セッションのアクティブ時間。start_time_millis と end_time_millis は完全なセッション時間を定義しますが、アクティブ時間はこれより短く、active_time_millis で指定できます。セッション中の非アクティブ時間がわかっている場合は、STILL アクティビティ値を持つ com.google.activity.segment データポイントを介して挿入する必要もあります。 |
試してみよう:
以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。