クラウド データ構造
クラウド API で返却される主要オブジェクトのフィールド定義です。
|
ID 形式
各リソースは prefix 付き public ID(例: deal_..., inv_..., form_..., ak_...)を利用します。
全プロダクト共通の ID 規約Folder object
フォルダを表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | フォルダ ID |
object | string | 必須 | オブジェクト種別(`cloud.folder`) |
organization_id | string | 必須 | 組織 ID |
name | string | 必須 | フォルダ名 |
parent_id | string | null | 任意 | 親フォルダ ID |
created_at | string | 必須 | 作成日時 (ISO 8601) |
updated_at | string | 必須 | 更新日時 (ISO 8601) |
{
"id": "folder_01JQ3KABC",
"object": "cloud.folder",
"organization_id": "org_01HZXYZ",
"name": "Project Documents",
"parent_id": null,
"created_at": "2026-01-05T09:00:00Z",
"updated_at": "2026-02-18T14:00:00Z"
}File object
ファイルを表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | ファイル ID |
object | string | 必須 | オブジェクト種別(`cloud.file`) |
organization_id | string | 必須 | 組織 ID |
name | string | 必須 | ファイル名 |
folder_id | string | null | 任意 | フォルダ ID |
mime_type | string | 必須 | MIME タイプ |
size | number | 必須 | ファイルサイズ(バイト) |
created_at | string | 必須 | 作成日時 (ISO 8601) |
updated_at | string | 必須 | 更新日時 (ISO 8601) |
{
"id": "file_01JQ3KDEF",
"object": "cloud.file",
"organization_id": "org_01HZXYZ",
"name": "proposal.pdf",
"folder_id": "folder_01JQ3KABC",
"mime_type": "application/pdf",
"size": 1048576,
"created_at": "2026-02-15T11:00:00Z",
"updated_at": "2026-02-15T11:00:00Z"
}