プロジェクト管理 データ構造
プロジェクト管理 API で返却される主要オブジェクトのフィールド定義です。
|
ID 形式
各リソースは prefix 付き public ID(例: deal_..., inv_..., form_..., ak_...)を利用します。
全プロダクト共通の ID 規約Project object
プロジェクト管理のプロジェクトを表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | プロジェクト ID |
object | string | 必須 | オブジェクト種別(`project.project`) |
organization_id | string | 必須 | 組織 ID |
name | string | 必須 | プロジェクト名 |
description | string | null | 任意 | 説明 |
start_date | string | null | 任意 | 開始日 |
end_date | string | null | 任意 | 終了日 |
created_at | string | 必須 | 作成日時 (ISO 8601) |
updated_at | string | 必須 | 更新日時 (ISO 8601) |
{
"id": "proj_01JQ3KXYZ",
"object": "project.project",
"organization_id": "org_01HZXYZ",
"name": "Website Redesign",
"description": "Redesign the corporate website",
"start_date": "2026-02-01",
"end_date": "2026-04-30",
"created_at": "2026-01-20T09:00:00Z",
"updated_at": "2026-02-20T10:00:00Z"
}Task object
プロジェクト内のタスクを表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | タスク ID |
object | string | 必須 | オブジェクト種別(`project.task`) |
project_id | string | 必須 | プロジェクト ID |
group_id | string | null | 任意 | タスクグループ ID |
name | string | 必須 | タスク名 |
start_date | string | null | 任意 | 開始日 |
end_date | string | null | 任意 | 終了日 |
progress | number | 必須 | 進捗率 (0-100) |
assigned_to | string | null | 任意 | 担当者 ID |
created_at | string | 必須 | 作成日時 (ISO 8601) |
updated_at | string | 必須 | 更新日時 (ISO 8601) |
{
"id": "task_01JQ3KABC",
"object": "project.task",
"project_id": "proj_01JQ3KXYZ",
"group_id": "grp_01JQ3KDEF",
"name": "Design mockups",
"start_date": "2026-02-01",
"end_date": "2026-02-14",
"progress": 75,
"assigned_to": "usr_01HZABC",
"created_at": "2026-01-25T09:00:00Z",
"updated_at": "2026-02-18T16:00:00Z"
}Link object
タスク間の依存関係リンクを表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | リンク ID |
object | string | 必須 | オブジェクト種別(`project.link`) |
project_id | string | 必須 | プロジェクト ID |
source_id | string | 必須 | 先行タスク ID |
target_id | string | 必須 | 後続タスク ID |
type | "finish_to_start" | "start_to_start" | "finish_to_finish" | 必須 | リンク種別 |
{
"id": "link_01JQ3KGHI",
"object": "project.link",
"project_id": "proj_01JQ3KXYZ",
"source_id": "task_01JQ3KABC",
"target_id": "task_01JQ3KJKL",
"type": "finish_to_start"
}