Users.sessions: update

注: 認証が必要です。

特定のセッションを更新または挿入します。 実習をご覧ください。

リクエスト

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 で指定できます。セッション中の非アクティブな時間がわかっている場合は、com.google.activity.Segment データポイントを介して、さらに STILL アクティビティ値とともに挿入されます。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "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 で指定できます。セッション中の非アクティブな時間がわかっている場合は、com.google.activity.Segment データポイントを介して、さらに STILL アクティビティ値とともに挿入されます。

お試しください。

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