> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/ja/guan-li/project-folders.md).

# プロジェクトフォルダ

プロジェクトをフォルダにまとめてワークスペースを整理し、必要に応じて SSO でアクセスを制限します。

## 概要

プロジェクトフォルダは、ワークスペース内のプロジェクトの整理とセキュリティを向上させます。フォルダを使うと、1つ以上のプロジェクトを明確なカテゴリにまとめられるため、プロジェクトの移動、整理、管理がしやすくなります。さらに、SSO が有効なワークスペースでは、フォルダ内のプロジェクトへのアクセスを特定のチームメンバーに制限でき、データのセキュリティが強化されます。

## Webアプリ

#### フォルダの表示

ワークスペースの表示では、保有しているプロジェクトフォルダは上部に表示されます。ワークスペースには1つ以上のプロジェクトフォルダを作成でき、各プロジェクトフォルダには1つ以上のプロジェクトを含めることができます。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-14fd4a03b0a908ce48c534106c592c407099c4eb%2FScreenshot%202024-06-26%20at%2010.36.05.png?alt=media" alt=""><figcaption><p>プロジェクトフォルダはワークスペースの上部に表示されます</p></figcaption></figure>

#### フォルダの作成

新しいフォルダを作成するには、右上の「+ 新しいフォルダ」ボタンをクリックします。フォルダ名を入力して「保存」をクリックしてください。ページはプロジェクトフォルダに移動し、そこで新しいプロジェクトを作成できます。プロジェクトフォルダ表示から作成されたプロジェクトは、自動的にそのフォルダに追加されます。

[\[Roboflow Documentation\] Project Folders - Create Project - 動画を見る](https://www.loom.com/share/aefb3b5fd1ea40cdb4183c903f13d9c8)

<figure><img src="https://cdn.loom.com/sessions/thumbnails/aefb3b5fd1ea40cdb4183c903f13d9c8-with-play.gif" alt=""><figcaption><p>新しいプロジェクトフォルダの作成</p></figcaption></figure>

#### フォルダ名の変更

フォルダ名を変更するには、プロジェクトフォルダのドロップダウンメニュー（3つの点）をクリックします。「名前を変更」オプションを選択し、新しい名前を入力してください。「保存」をクリックすると、フォルダ名が新しい名前に変更されます。

[\[Roboflow Documentation\] Project Folders - Rename Folder - 動画を見る](https://www.loom.com/share/63508a2ff629454690ac0957d5cfc990)

<figure><img src="https://cdn.loom.com/sessions/thumbnails/63508a2ff629454690ac0957d5cfc990-with-play.gif" alt=""><figcaption></figcaption></figure>

#### フォルダ内のプロジェクトの管理

既存のプロジェクトをフォルダに移動できます。プロジェクトを移動するには、プロジェクトのドロップダウンメニュー（3つの点）をクリックして「プロジェクトを移動」を選択します。すると、移動先を選択するポップアップが表示されます。プロジェクトフォルダがない場合は、「新しいフォルダ」ボタンをクリックして追加できます。そうでない場合は、既存のフォルダを移動先として選択できます。プロジェクトをフォルダの外に移動したい場合は、ワークスペース名を選択します。

プロジェクトやフォルダをフォルダカードにドラッグして、その場所に移動することもできます。複数のフォルダを選択した場合は、そのうちの1つをドラッグすると、すべてを移動できます。

[\[Roboflow Documentation\] Project Folders - Move Project - 動画を見る](https://www.loom.com/share/a411cabb98f14255b07c3c2e209c3abd)

<figure><img src="https://cdn.loom.com/sessions/thumbnails/a411cabb98f14255b07c3c2e209c3abd-with-play.gif" alt=""><figcaption></figcaption></figure>

#### フォルダの削除

プロジェクトフォルダのドロップダウンメニュー（3つの点）をクリックし、「削除」オプションを選択すると、フォルダを削除できます（この操作は元に戻せません）。フォルダを削除しても、その中の内容は削除されません。フォルダ内のプロジェクト、Workflows、サブフォルダは1つ上のフォルダに移動し、最上位にあるフォルダの場合はワークスペースレベルに移動します。

[\[Roboflow Documentation\] Project Folders - Delete Folder - 動画を見る](https://www.loom.com/share/852e70b217de4d5d9ca79bef41903ad9)

<figure><img src="https://cdn.loom.com/sessions/thumbnails/852e70b217de4d5d9ca79bef41903ad9-with-play.gif" alt=""><figcaption></figcaption></figure>

### カスタムフォルダ権限

フォルダはプロジェクトを整理・管理するのに非常に便利ですが、一部のフォルダに対してカスタム権限を設定することもできます。たとえば、ワークスペースの一部のメンバーだけに特定のフォルダ内のプロジェクトへのアクセスを許可したい場合、Roboflow の SSO 統合を使って実現できます。開始するにはサポートにご連絡ください。設定をお手伝いします。

### プロジェクトフォルダ API

プロジェクトフォルダは Roboflow API を使用してプログラムから管理できます。利用可能なエンドポイントの詳細については、 [プロジェクトフォルダ API](#http-api) ドキュメントをご覧ください。

## HTTP API

{% hint style="info" %}
プロジェクトフォルダは Enterprise プランで利用できます。
{% endhint %}

フォルダはプロジェクトの URL スラッグを受け取り、フォルダ ID を返します。フォルダ名を指定するすべての呼び出しでは、作成または一覧取得で得た ID を使用してください。

### フォルダを作成

{% openapi src="/files/bf0b712bfa99c4790e9e9714756a8d4d04eb655c" path="/{workspace}/groups" method="post" %}
[project-folders.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### フォルダを一覧表示

渡す `groupId` 単一のフォルダを取得するには。

{% openapi src="/files/bf0b712bfa99c4790e9e9714756a8d4d04eb655c" path="/{workspace}/groups" method="get" %}
[project-folders.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### フォルダを更新

{% openapi src="/files/bf0b712bfa99c4790e9e9714756a8d4d04eb655c" path="/{workspace}/groups/{folderId}" method="post" %}
[project-folders.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### フォルダにプロジェクトを追加

{% openapi src="/files/bf0b712bfa99c4790e9e9714756a8d4d04eb655c" path="/{workspace}/groups/{folderId}/projects" method="patch" %}
[project-folders.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### フォルダからプロジェクトを削除

削除されたプロジェクトは、フォルダがネストされている場合でもワークスペースの最上位に移動します。

{% openapi src="/files/bf0b712bfa99c4790e9e9714756a8d4d04eb655c" path="/{workspace}/groups/{folderId}/projects" method="delete" %}
[project-folders.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### フォルダを削除

これは元に戻せません。

{% openapi src="/files/bf0b712bfa99c4790e9e9714756a8d4d04eb655c" path="/{workspace}/groups/{folderId}" method="delete" %}
[project-folders.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

## Python SDK

プロジェクトフォルダは、ワークスペース内のプロジェクトを入れ子のグループに整理します。Python SDK では、フォルダの一覧表示と作成を直接 `ワークスペース`；更新と削除は低レベルの `rfapi` アダプターから利用できます。

{% hint style="info" %}
プロジェクトフォルダは Enterprise 機能です。フォルダのエンドポイントは `403` Enterprise 以外のワークスペースでは空を返します。
{% endhint %}

### フォルダを一覧表示

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
workspace = rf.workspace()

folders = workspace.list_folders()
for folder in folders.get("data", []):
    print(folder["id"], folder["name"])

```

### フォルダを作成

```python
folder = workspace.create_folder(
    name="学習データ",
    parent_id=None,                              # オプション、ネスト用
    project_ids=["my-detector", "other-project"], # オプション、作成時に追加
)
print(folder["id"])

```

#### パラメータ

* `name` (str) - ウェブアプリに表示されるフォルダ名。
* `parent_id` (str, optional) - ネスト先となる既存フォルダの ID。最上位フォルダにする場合は省略します。
* `project_ids` (list\[str], optional) - 作成時にそのフォルダへ移動するプロジェクト ID。

### フォルダを取得

```python
from roboflow.adapters import rfapi

folder = rfapi.get_folder("YOUR_API_KEY", workspace.url, "<folder-id>")
print(folder)
```

### フォルダ名の変更または更新

```python
from roboflow.adapters import rfapi

rfapi.update_folder(
    "YOUR_API_KEY",
    workspace.url,
    "<folder-id>",
    name="新しい名前",
)
```

### フォルダを削除

```python
from roboflow.adapters import rfapi

rfapi.delete_folder("YOUR_API_KEY", workspace.url, "<folder-id>")
```

フォルダを削除しても、そのプロジェクトは削除されません。フォルダ内のプロジェクト、Workflows、サブフォルダは親フォルダ、またはワークスペースの最上位に移動します。

## CLI

コマンドラインから、ワークスペースのフォルダを作成、一覧表示、更新、削除できます。

### フォルダ一覧

```bash
roboflow folder list
```

JSON出力の場合:

```bash
roboflow folder list --json
```

### フォルダの詳細を取得

```bash
roboflow folder get <folder-id>
```

```bash
roboflow folder get <folder-id> --json
```

### フォルダを作成

```bash
roboflow folder create "学習データ"
```

#### オプション

| フラグ          | 説明                      |
| ------------ | ----------------------- |
| `--parent`   | 親フォルダ ID（ネスト用）          |
| `--projects` | 含めるプロジェクト ID をカンマ区切りで指定 |

プロジェクトの例:

```bash
roboflow folder create "Q2 モデル" --projects my-project,other-project
```

### フォルダを更新

フォルダ名を変更:

```bash
roboflow folder update <folder-id> --name "新しい名前"
```

### フォルダを削除

```bash
roboflow folder delete <folder-id>
```

### JSON出力

すべてのフォルダコマンドは次をサポートします `--json` 構造化出力の場合:

```bash
roboflow folder list --json | jq '.[].name'
roboflow folder create "マイフォルダ" --json
```

終了コード: 0 = 成功, 1 = エラー, 2 = 認証エラー, 3 = 見つかりません。
