export_observation_data
Export observation data history as a CSV file saved to your local path, with a summary preview of rows, columns, and date range. Filter by tenant, group, device, and dates to get exactly the needed records.
Instructions
受信データ履歴を CSV でエクスポートします。
tenant_id は list_tenants で、group_cd は list_groups で、device_cd は list_devices で 取得してください。全件を対象にする場合は group_cd / device_cd に all を指定します。
必要な権限レベル: システム管理者(user_level=1)、テナント管理者(user_level=2)、 現場管理者(user_level=3)。権限が不足すると 403 になります。
CSV 本文はそのまま返しません（コンテキストを使い切るため）。 既定では行数・カラム名・先頭20行のプレビュー・データ期間の要約を返し、 CSV 本体は UTF-8 のファイルとして保存してその絶対パスを返します。 save_path を指定するとそのパス（絶対パスのみ・ディレクトリ可）へ、 未指定なら一時ディレクトリへ保存します。既存ファイルは上書きせず別名で保存します。 分析にはこのファイルを使ってください。
取得件数が API の上限を超えると 400 になります。その場合は期間を短くするか、 device_cd を all から個別の地点に絞って再実行してください。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | レスポンスの言語（ja / en） | ja |
| end_date | Yes | 終了日(YYYY-MM-DD)。未来日は API 側で現在時刻に丸められる | |
| group_cd | Yes | 現場CD。全現場を対象にする場合は all | |
| device_cd | Yes | 地点CD。全地点を対象にする場合は all | |
| save_path | No | CSVの保存先の絶対パス（ファイル名またはディレクトリ）。相対パスはエラー。未指定なら一時ディレクトリに保存してパスを返す | |
| tenant_id | Yes | テナントID(UUID)。list_tenants で取得できる | |
| start_date | Yes | 開始日(YYYY-MM-DD) | |
| output_type | Yes | 表示項目形式（raw_data=生値、formatted_data=整形データ） |